Christchurch Flood -V1.0.2

From RiskScape Wiki
Revision as of 02:06, 1 November 2017 by Arnoldjr (talk | contribs) (Copied from Chch Flood -V1.0.2, revision 3491)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Christchurch Flood Tutorial

This tutorial is for users of RiskScape and provides an introduction to the functionality of RiskScape. You can work through this tutorial at your own pace once you have successfully installed RiskScape onto your PC and familiarised yourself with the RiskScape working environment.

  Download Christchurch Flood Tutorial - UoC-2017-Tutorial1.pdf


For this exercise we will use a scenario from a Storm tide flood event. This set of events were calculated using the NIWA climate change toolbox.

Open RiskScape from the Start Menu

Using the programs menu find and start RiskScape, or double click on the RiskScape icon on your desktop

Log in to RiskScape

Log in with your username and password, or create a RiskScape account


When you first start RiskScape you may be prompted to accept the End User Agreement.

Please click “I accept “ and proceed.

Download layers from the repository

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.


Click the ‘Repository’ icon,

Click “Server” in the bottom right of the pop up window.


Select the layer you are interested in in the server list


Click the ”Type” header to order the list by type of layer


Right click and Download the layers

This example requires the following layers:

  1. Canterbury Buildings, (Asset)
  2. New Zealand suburbs (or meshblocks) (Aggregation)
  3. Storm-tide-New-Zealand-Buildings (Hazard)
  4. Storm-Tide-Avon-Heathcote-Estuary (Vulnerability)

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


A blue tick indicates that the layer has downloaded

If you get a yellow triangle error instead of a tick, close and re- open Riskscape

Close the repository window by clicking ‘X’


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.

  1. Canterbury Buildings, (Asset)
  2. New Zealand suburbs (Aggregation)
  3. Storm-tide (Hazard)
  4. Damage State (Losses) and any that appear tickable

Note: You can select multiple losses


click Add to library (encircled).


Note: “Add to Library” will appear selectable when 4 valid choices are selected

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 the storm-tide example is used to illustrate. Refine the asset data by choosing whether you want to use the complete asset dataset, or use a subset.

Select Use complete dataset and click Next.


click Next again


Choose the scenario MHWS 2090 Flood Event (0.8m SLR)


Select a vulnerability model.

Click Next


Choose “Day” and click “Next”


Write in a name for your scenario. This is how it will appear in your Library. We will call ours ‘Christchurch Flood 80cm SLR’.

Click Finish.


Compute your scenario

Click on the “Play” button to run the scenario.

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

Note: The analysis will be finished when the ‘play’ symbol disappears. this will take 5-10 minutes


Examine aggregated results

On the Library tab find the icon to view/export aggregated results


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

Click ‘view’ and then ‘next’

Click "View" or use "Export" at this step to save results to .csv file to open in Excel

The aggregated results layer appears in the layers tab on the Right.


Adjust the map for optimal viewing by using the map tools.

Click the magnifying glass icon, and draw a box around the area you want to view. Zoom in to Christchurch (Heathcote) to get a better view of the results.

Examine per asset results

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


Click ‘view’ and then ‘next’

Click "View" or use "Export" at this step to save results to .csv file to open in Excel

The per asset layer(s) appears as more layer(s) in the Layers tab (white arrow).

Toggle the layer visibility to hide layers (circle).

Right click on layers to view additional functionality

Zoom in to view individual results


Hover the mouse over buttons to see the tool tips


Click the symbology button on the layers tab

You can change the colour bar in the drop down or select colours for each category


Use the colour wheel to select your colour


Click apply to view your changes

Close the dialog using the “X


Want to keep going...? try out these extension exercises

Run through the steps in this Tutorial again, but this time either

  1. alter the aggregation to New Zealand Meshblocks (Aggregation)
  2. select “Night” for the time instead of “Day” during step 5
  3. choose a different sea level or ARI

Compare your two sets of outputs with one another...

Final Note

You Have Now Completed The Tutorial.

  • Please note: This tutorial is for demonstration purposes only and the results produced are not intended to inform natural hazard management decision making. Please contact RiskScape at If you would like to find out more about using RiskScape for natural hazard management activities.

Please submit your feedback to The RiskScape Team or via the JIRA system.