From RiskScape Wiki
Revision as of 00:37, 28 November 2017 by Arnoldjr (talk | contribs) (Analysis Wizard Selections)

Jump to: navigation, search

Go to Overview


To show you how to create a scenario and run an analysis we use an example. This example is illustrated as a tutorial and takes you step by step through the creation of a scenario, running the analysis and examining the results.

Wellington 1855 Earthquake

To get the best out of your simulation consider what you would like to find out before you start.

Identify each of the following inputs for the scenario:

  • A location (e.g. city)
  • An asset type (e.g. buildings or infrastructure)
  • Whether you want the results for each asset (‘per- asset’), or summarised across an area, such as a district, grid, or land-use zone (‘aggregated’).
  • A hazard
  • A loss (or multiple losses; e.g. human losses, or asset damage state).

For example, in this guide, we will run a scenario to determine the number of buildings that are severely (or critically) damaged in the Wellington area by an 1855 Wairarapa earthquake.

Go to "what can I use my results for?"

Load RiskScape

Using the programs menu find and start RiskScape, or double click on the RiskScape icon on your desktop. RiskScape is loading when you see the image below appear on your screen


A map appears. The boxes on the left, labelled Asset, Aggregation, Hazard, and Losses, need to have layers added to them, so that you can run a scenario.


Get layers from Repository

Click the ‘Repository’ icon, and in the bottom right of the pop up window, ensure ‘server’ is selected.

The menu button to access the Repository.

For more detailed help go to Repository Guide

From the "server" tab of the repository - download the layers for the simulation.

List of layers in the Server Repository.

Check on the "installed" tab that the layers have been downloaded.

List of Installed Layers.

Repeat the steps to download from the repository each of the required layers:

  • Asset layer = Wellington-buildings
  • aggregation layer = Wellington grid
  • hazard layer = Earthquake Model
  • losses layer = Earthquake MMI Fragility Model
  • Resources layer = Liquefaction Potential and Soil Class (Resources layers are only needed when running an earthquake scenario).

-Click on -type- at the top of the list to order the layers by type

Close the repository window by clicking ‘X’

Close the Repository.

Select Layers for Computation

Your selected layers should now be visible in the boxes on the left side of the window.

Tick your selection in each of the Assets, Aggregation, Hazard, and Losses boxes in the analysis tab.

You can select multiple losses.

Assets = Wellington buildings; Aggregation = Wellington grid; Hazard = earthquakes; Losses = damage state


Click ‘Add to library’.

Analysis Wizard Selections

The Analysis wizard pop up window appears.


In the pop up window, click ‘Next’. The options that appear in the wizard depend on which hazard you have chosen. Here the process using our earthquake example is used to illustrate.

Refine the asset data by choosing whether you want to use the complete asset dataset, or use a subset.

We’ll choose ‘use complete dataset’.

Click Next.


Choose a hazard model. We will select ‘Earthquake Model’.


Choose a configuration method. We will choose a ‘Historic’ event,

Click Next.


Select the 1855 Wairarapa earthquake.

Click Next.


We will select the Earthquake buildings fragility model,


Select day or night for the timing of the scenario


Write in a name for your scenario. This is how it will appear in your Library.

We will call ours ‘Wairarapa 1855 earthquake’.

Click Finish.


The scenario you have just created appears on the left of the screen, in the Library tab.

Compute your scenario

Click on the blue ‘play’ symbol to run the Scenario.

You can watch the progress of the analysis in the Console window.


The analysis will be finished when the ‘play’ symbol disappears and the processing icon (circled above) stops whirring.

View Your Results

Decide whether you would like to view your results at an aggregated or per-asset scale, and click on the appropriate icon


Per-asset results will show the estimated results for individual assets (buildings, etc.).

Aggregated results will use the option you selected in the Aggregation box within the Analysis tab when you were running your scenario.

We will use the aggregated option.

Click ‘view’ and then ‘next’


Adjust the map for optimal viewing by using the map tools. Click the magnifying glass icon, and draw a box around the area you wish to view. Start by clicking at the top left corner of the box you wish you draw, and drag it down to the bottom right corner. You can also drag the map using the ‘pan’ tool.



Adjust the appearance of the results by clicking on the ‘symbology’ icon


The symbology pop-up box appears.


Select a ‘value field’ from the drop down box. We will use ‘severe’ damage state of the buildings.


Select a colour ramp from the drop down box. We will use the blue-to-red option.


Change the number of classes and ranges if you wish, and click ‘classify’ We will keep ‘Classes’ at 5, and click ‘classify’. The range of each class is automatically assigned. Adjust these as desired by typing in the ‘min’ and ‘max’ boxes, as we have done.



Adjust the transparency (%) of the layer Drag the button along the bar to the desired transparency. 0% = completely transparent, 100% = opaque. We will select 60%.


Border options

Border options include using a coloured or ‘glow’ border around each of the aggregation units on the map. We will stick with ‘none’.

Click ‘apply’ and then exit from the symbology window by clicking ‘x’.


The results show the number of assets with the selected losses for each aggregation unit.

For example, red squares in our results show the areas in Wellington likely to have between 20 and 30 ‘severely’ damaged buildings caused by an earthquake with the same parameters as the 1855 Wairarapa event.



When the legend icon is clicked (shown circled in the image below), the Legend appears in the Layers tab on the right of the screen, showing the ranges for each colour. The ranges and colours can be changed in the ‘Symbology’ window. To hide the legend, click the legend icon again.


View/Hide layers

Click the ‘show or hide selected layer’ icon (circled below) to turn layers on and off. Items can be deleted from the ‘Layers’ tab by right clicking on the item and choosing ‘delete’.


More User Guides