Tutorial-Wellington1855-EQ-V1.0
Tutorial[edit]
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[edit]
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[edit]
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[edit]
Click the ‘Repository’ icon, and in the bottom right of the pop up window, ensure ‘server’ is selected.
For more detailed help go to Repository Guide
From the "server" tab of the repository - download the layers for the simulation.
Check on the "installed" tab that the layers have been downloaded.
Repeat the steps to download from the repository each of the required layers:
- Asset layer = Wellington-buildings
- aggregation layer = New Zealand-Meshblock
- 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’
Select Layers for Computation[edit]
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 = New Zealand-Meshblock; Hazard = earthquakes; Losses = damage state
Click ‘Add to library’.
Analysis Wizard Selections[edit]
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[edit]
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[edit]
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.
Symbology[edit]
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.
Transparency[edit]
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[edit]
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.
Legend[edit]
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[edit]
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[edit]
- Go to Exporting Your Results
- Go to Using your Results
- Changing the coordinate system
- Changing the background map
- Identifying attributes of assets
