Coastal Adaptation to Sea Level Rise Tool (COAST)

Transcription

1 Built on the Global Mapper SDK Coastal Adaptation to Sea Level Rise Tool (COAST) Tutorial v3.0 4/8/2015

2 Table of Contents Introduction... 3 COAST Scenario Data Requirements... 3 Setting Up a COAST Scenario... 4 Load the Data Layers... 4 Save the Workspace... 4 Select the COAST Model... 5 Enter Model Parameters... 5 Define a One-Time Storm Event Scenario... 5 Define a Cumulative Storm Event Scenario... 8 Results Define the Asset to Be Modeled Using Multiple Assets in a Scenario Using Multiple DDFs in a Scenario Using Feature Styles in the COAST Viewer Using Asset-Specific Exceedance Curves Using KML Export Styles Running a Scenario Batch Appendix A: Sample Model Parameter Data Editing Model Parameters Exceedance Curve Data Dynamic Exceedance Curve Eustatic Sea-Level Rise Data Base Water Level Data Local SLR Data Depth/Damage Function Data Adaptation Data About Blue Marble Geographics COAST Damage Assessment Tool Tutorial Page 2

3 Introduction This document provides a tutorial for the COAST Damage Assessment Tool v3.0, built on the Global Mapper SDK. In order to perform the steps in the tutorial, you will need to download the CoastTutorialData_3.0.zip file from the same location where you downloaded the COAST tool. The COAST Damage Assessment Tool can be used to manage assets with regard to specific climate change scenarios. These scenarios include, but are not limited to, sea level rise, coastal area flooding, and local disaster projection. The user can create a specific exceedance curve attaching probability of occurrence to water-level rise for a given climate change scenario over a certain time period. Multiple climate change and adaptation scenarios, each with multiple time periods, will be possible (e.g., 2010, 2040, 2070, and 2100). The COAST tool calculates the expected value (EV) of the damages for that climate change scenario and cumulative damages over the time period leading up to the event. The user specifies two data layers that act as input to the tool: 1. A base land-elevation dataset defining the area to be modeled. This is typically a raster generated from LIDAR data. 2. A vector layer defining the asset to be included in the model, e.g., land parcels, building footprint, etc. This layer must contain an attribute defining the asset value to be used in the damage calculations. The user also needs to provide a depth-damage function (DDF) for each asset and adaptation strategy. A DDF defines the percentage of the assets value that is lost for each increment in flood depth, and is used to calculate the EV for damages. Once the input layers, climate-change scenario, and DDFs have been identified, the tool will produce the following outputs: 1. A KML layer showing the flooded area and the calculated damages for the defined flooding scenario. The assets will be extruded to indicate the relative amount of damages. 2. A KML layer showing the flooded area and calculated damages based only on Mean Higher High Water (MHHW) and the rise in sea level for the scenario. Again, the assets will be extruded to show the relative damage amounts. 3. An Esri shapefile containing the assets in the flooded area for the flooding scenario. 4. An Esri shapefile containing the assets that are flooded based only on MHHW and the rise in sea-level for the scenario. 5. An Excel spreadsheet containing the cumulative expected damages for the base "no action" scenario and for each specified adaptation. COAST Scenario Data Requirements In order to set up a COAST scenario, you will need the following data. The tutorial data set contains sample data and model parameters. COAST Damage Assessment Tool Tutorial Page 3

4 1. A base land elevation layer. 2. A base asset data layer. This is a vector file containing features representing the assets to be included in the model, and must be stored in an Esri shapefile. This layer must have an attribute containing the asset value to be used in the damage calculations. 3. Exceedance curve data a. Storm surge heights and probabilities (recurrence intervals) b. Eustatic Sea-Level Rise model c. Base water level d. Local Sea-Level Rise data (optional) 4. Depth/Damage functions 5. Adaptation data, if you are planning to model an adaptation. Setting Up a COAST Scenario This section provides a short tutorial that illustrates how to set up a COAST scenario. The data used in this tutorial can be downloaded from the same web site where you downloaded the COAST tool. This tutorial assumes that the data is located on your local hard drive at C:\CoastTutorialData. Load the Data Layers The first step in setting up a COAST scenario is to load the required data layers. 1. Select the File->Load Data... option. 2. Load the Land Elevation layer from: C:\CoastTutorialData\Portland\Land Elevation\BackCove_clip.tif. 3. The Elevation Layer Options dialog will be displayed. Set the Vertical Unit to FEET, and leave the check next to Interpret negative elevation values as 0. Click the OK button. You should see the data loaded into the viewer. 4. Select the File->Load Data... option again. 5. Load the Asset layer from C:\CoastTutorialData\Portland\Assets\Parcels_BackCove_clip.shp. 6. You should see the asset data loaded into the viewer. This data is a set of polygon features that should be aligned with the elevation data. Some of the features are outside of the elevation data, though. This is OK. Save the Workspace After you load your data, it is a good idea to save it in a workspace file to make it easier to work with your scenarios in the future. 1. Select the File->Save Workspace... menu option. A Save File dialog will be displayed. 2. Browse to the C:\CoastTutorialData\Portland directory, and type in "Portland.gmw" for the file name. 3. Click OK. Your workspace will be saved. COAST Damage Assessment Tool Tutorial Page 4

5 Select the COAST Model In order to run the COAST model, you must choose it as the current model. 1. Choose the Model->Select Model menu item. The Select Model window will be displayed. 2. Select COAST Model from the list. 3. Click the OK button. After you click OK on the Select Model window, choosing the COAST model, the title of the main window will be updated to include COAST Damage Assessment Tool. Enter Model Parameters You will need to define a set of model parameters before you can run a scenario. The tutorial data set includes a sample model parameters file that you can use for the following exercises. If you want to create your own model parameters file, you can follow the instructions in Appendix A: Sample Model Parameter Data on page 23. Define a One-Time Storm Event Scenario The next step is to enter the information that defines a one-time storm event scenario. 1. Choose the Model->Run Model Scenario->Estimate One-Time Storm Damage menu item. 2. If you have not used the appendix to define a set of model parameters, a Select a COAST Model Parameters File dialog will be displayed. Browse to C:\CoastTutorialData\ModelParms\Tutorial1.coastparms to tell COAST to use the sample parameters file. Click Open. 3. The Estimate One-time Storm Damage dialog will now be displayed. Note that the Model Parameters File field is filled in with the location of the sample model parameters file (or the one that you created.) 4. Under Scenarios, click the New... button. The New COAST Scenario dialog will be displayed. Type in the name, "Tutorial" and click OK. 5. Under Elevation Data, in the Layer field, the BackCove_clip.tif layer should already be selected, since you only loaded one elevation layer. If you loaded more than one elevation layer, you will need to select the one you want to use for this scenario. 6. Follow the steps in Define the Asset to Be Modeled on page 11 to set up an asset to be included in the model. When you have finished, return to this step in the tutorial. The asset you added will now be selected. Make sure the box next to its name is checked. 7. Choose "Portland Exceedance Curve" from the Exceedance Curve list. If there is only one defined in the model parameters file, it should already be selected. COAST Damage Assessment Tool Tutorial Page 5

6 8. Choose "V&R 2009 High" from the Eustatic SLR list. This represents the high end of the global sea-level rise estimates as published by Vermeer and Rahmstorf in If there is only one defined in the model parameters file, it should already be selected. 9. Choose "MHHW Portland, Maine" from the Base Water Level list. If there is only one defined in the model parameters file, it should already be selected. 10. Choose "Portland Local SLR" from the Local SLR list. 11. Choose "<None>" from the Adaptation list. We will not be using an adaptation in this tutorial. 12. In the Discount Rate field, type "2.5". 13. In the Year field, enter "2030". 14. Choose "100 Y" from the Recurrence Interval list. 15. As you change parameters that affect the overall water-level rise for the scenario, the value in Computed Storm Event SLR will be recalculated. If you change the unit in the associated list, the value will be converted to the selected unit. Change the unit to "FEET" and note that the computed SLR is " ". 16. In the KML/KMZ Options section, click the Browse... button to choose a location and file name for the output KML or KMZ file. Choose the file "C:\CoastTutorialData\Portland\Output\Tutorial_OneTime.kmz". 17. Type "15000" in the Scale: 1 Elevation Unit Per $ field. (The damage values in this scenario are pretty large, so this flattens the output data to make the output map look better.) 18. You can use the Edit KML Export Styles button to change the styling that will be applied to the asset damage extrusions in the KML/KMZ output. For the purposes of this tutorial, we will use the default styling. A tutorial on this topic can be found in Using KML Export Styles on page Type "Back Cove Tutorial" in the Legend Title field. 20. Click the Edit Legend... button. The Edit Legend dialog will be displayed. 21. Type "assessed value" in the Asset Type field. Leave the default values for the rest of the options. Click OK. The Edit Legend dialog will close. COAST Damage Assessment Tool Tutorial Page 6

7 22. You can use the Advanced Options button to choose some additional processing options for your COAST scenario. See the COAST documentation for a description of what these options do. For the purposes of this tutorial, we will be using the default settings. 23. The Run Batch button allows you to run several scenarios in one session using different exceedance curves, eustatic SLR rise models, etc. For a tutorial on batch processing, see Running a Scenario Batch on page The Estimate One-time Storm Damage window should look like this: COAST Damage Assessment Tool Tutorial Page 7

8 25. Click the OK button. The COAST tool will perform validation and run the scenario. You will see progress dialogs for the different steps in the process, along with a message when the scenario has finished. 26. When the scenario has been completed, it is a good idea to save the scenario definition by saving the workspace. Define a Cumulative Storm Event Scenario The next step is to enter the information that defines a cumulative storm event scenario. 1. Choose the Model->Run Model Scenario->Estimate Cumulative Storm Damage menu item. 2. If you have not used the appendix to define a set of model parameters, a Select a COAST Model Parameters File dialog will be displayed. Browse to C:\CoastTutorialData\ModelParms\Tutorial1.coastparms to tell COAST to use the sample parameters file. Click Open. 3. The Estimate Cumulative Storm Damage window will now be displayed. Note that the Model Parameters File field is filled in with the location of the sample model parameters file (or the one that you created.) 4. Under Scenarios, click the New... button. The New COAST Scenario dialog will be displayed. Type in the name, "Tutorial Cumulative" and click OK. 5. Under Elevation Data, in the Layer field, the BackCove_clip.tif layer should already be selected, since you only loaded one elevation layer. If you loaded more than one elevation layer, you will need to select the one you want to use for this scenario. 6. The asset you defined when setting up the one-time storm event scenario should already be in the list under Asset Data. Use that asset for this step by clicking the name to place a check in the box. If you would like to define a different asset, follow the steps in Define the Asset to Be Modeled on page 11 to set up an asset to be included in the model. When you have finished, return to this step in the tutorial. 7. Choose "Portland Exceedance Curve" from the Exceedance Curve list. If there is only one defined in the model parameters file, it should already be selected. 8. The Eustatic SLR list contains all of the eustatic SLR definitions in the model parameters file. You can choose one or more eustatic SLR curve to be included in the cumulative damage report. Place a check next to both of the eustatic SLR curves defined in the tutorial data. 9. Choose "MHHW Portland, Maine" from the Base Water Level list. If there is only one defined in the model parameters file, it should already be selected. 10. Choose "Portland Local SLR" from the Local SLR list. 11. Choose "<None>" from the Adaptation list. We will not be using an adaptation in this tutorial. 12. In the Discount Rate field, type "2.5". 13. In the Start Year field, enter "2013". 14. In the End Year field, enter "2100". 15. In the Output section, click the Browse... button to choose a location and file name for the output Damage Report File. Choose the file COAST Damage Assessment Tool Tutorial Page 8

9 "C:\CoastTutorialData\Portland\Output\Tutorial_Cumulative.xlsx" 16. You can use the Advanced Options button to choose some additional processing options for your COAST scenario. See the COAST documentation for a description of what these options do. For the purposes of this tutorial, we will be using the default settings. 17. The Estimate Cumulative Storm Damage window should look like this: 18. Click the OK button. The COAST tool will perform validation and run the scenario. You will see progress dialogs for the different steps in the process, along with a message when the model has finished. COAST Damage Assessment Tool Tutorial Page 9

10 19. When the scenario has finished, it is a good idea to save the scenario definition by saving the workspace. Results After the scenario has run, your output data will be in the location you specified in the KML/KMZ Options or in the Damage Report File. The COAST process creates some layers containing the flooded area for the total water-level rise value that was calculated for the scenario. (By default, those layers are hidden. Select the File->Layer Manager option, or right-click on the viewer window and choose Layer Manager..., if you want to display them.) If you run this scenario again, those layers can be reused to speed up the processing. It is a good idea to save your workspace again to keep your scenario definitions and these intermediate layers. Load the output KML/KMZ file into Google Earth. It should look like this: The blue extruded parcels are assets that were damaged due to water-level rise and storm surge. The height of each extrusion indicates the lost value for that asset relative to that of other assets; taller extrusions represent larger losses in value. Click on an extrusion to see the depth and lost value for that asset. COAST Damage Assessment Tool Tutorial Page 10

11 Since this scenario runs over the course of a relatively short time, only until 2030, there are no assets determined to be abandoned, or removed from inventory due to permanent inundation from sea level rise. To see the output from a scenario that includes abandoned features, change the year in the Onetime Event Damage scenario to 2100 and run it again. You should get KML output that looks like this: The brown areas represent the assets that were declared to be "abandoned" because they were permanently flooded by SLR during the interval from the current day to the scenario year. For the purposes of calculating the total storm damages, abandoned parcels have zero damage (because their value was lost as a result of being abandoned, rather than as a result of this storm event.) Click one of the brown polygons to see the flooding depth and year when the parcel was abandoned. Define the Asset to Be Modeled Follow the steps below to define the asset being modeled. For the purposes of this tutorial, the assets are land parcels, and the model will calculate damages based on assessed value and current plans for development. COAST Damage Assessment Tool Tutorial Page 11

12 1. In the Asset Data section, click the New Asset... button. The Edit Assets window will be displayed. 2. In the Asset Name field, type "Parcels". 3. For the Map Layer, choose "Parcels_BackCove_clip.shp" from the list. (Since there is only one possible asset layer in the map, the correct layer should already be selected.) 4. In the Asset Valuation section, select "VALUE" from the Asset Value Attribute list. This attribute represents the parcel's assessed value, which is the base valuation data we want to use. 5. Since we want to include planned future development in our model, we need to place a check next to Use alternate asset value, and choose an attribute from the list. The future development value for each parcel is stored in the "ADJ_VALUE" attribute. 6. Under the Additional Options section, we will set the appreciation rate to 1%, to reflect that we expect the parcel values to appreciate 1% faster than inflation. Put a check in the box next to Appreciation Rate, Per Year (Pct.). Type the value "1" into the field. 7. In this tutorial, we will not adjust the asset values to replacement value. Do not place a check next to Replacement value adjustment factor. 8. In this tutorial, we will use the same exceedance curve for all assets. Do not place a check next to Use Asset-Specific Exceedance Curve. 9. In the Depth/Damage Function (DDF) section, click to select the radio button next to Use Single DDF. 10. Pick "Army Corps Residential w/basement" from the Depth/Damage Function list. 11. In the Asset Elevation section, click to select the radio button next to Use the elevation layer value. COAST Damage Assessment Tool Tutorial Page 12

13 12. The Edit Assets window should look like this: 13. Click OK. The Define Asset window will close and the new asset will be added to the Asset list and selected. Using Multiple Assets in a Scenario Follow the steps below to add additional assets to a One-time Storm Damage scenario. This assumes that you have already completed the One-Time Storm Damage scenario defined earlier. Using additional assets in a Cumulative Storm Damage scenario requires very similar steps. 1. Select the File->Load Data... option. 2. Load the Roads layer from: C:\CoastTutorialData\Portland\Assets\Roads_BackCove.shp. 3. You should see a collection of line features representing roads loaded into the viewer. 4. Select the File->Load Data... option again. 5. Load the Asset layer from C:\CoastTutorialData\Portland\Assets\Sewers_BackCove.shp. COAST Damage Assessment Tool Tutorial Page 13

14 6. You should see point features representing sewer intercepts loaded into the viewer. 7. Choose the Model->Run Model Scenario->Estimate One-Time Storm Damage menu item. 8. If you have not created any COAST scenarios during this session, a Select a COAST Model Parameters File dialog will be displayed. Browse to C:\CoastTutorialData\ModelParms\Tutorial1.coastparms to tell COAST to use the sample parameters file. Click Open. 9. The Estimate One-time Storm Damage dialog will now be displayed. 10. Under Scenarios, select the "Tutorial" scenario created earlier. 11. You will need to set up two new assets. Follow the steps in Define the Asset to Be Modeled on page 11 using the data in the following table to set up the new assets to be included in the model. When you have finished, return to this step in the tutorial. Name Roads Sewers Asset Value Attribute BC_REPLVAL BC_REPLVAL Appreciation Rate 1 1 Single DDF Road DDF Sewer DDF Elevation Use elevation at center Use elevation at center 12. After adding the new assets, make sure that all three assets have checks next to their names, indicating that they will be used in the calculations. 13. Click the OK button. The COAST tool will perform validation and run the scenario. You will see progress dialogs for the different steps in the process, along with a message when the model has finished. 14. When displayed in Google Earth, the KML/KMZ output will now contain layers with extrusions for Roads and Sewers, in addition to the extrusions for the Parcels layer. Using Multiple DDFs in a Scenario Follow the steps below to add multiple DDFs to an asset that is part of the tutorial scenario. The steps assume that you have already set up the One-Time Event Damage scenario. 1. Choose the Model->Run Model Scenario->Estimate One-Time Storm Damage menu item. 2. If you have not created any COAST scenarios during this session, a Select a COAST Model Parameters File dialog will be displayed. Browse to C:\CoastTutorialData\ModelParms\Tutorial1.coastparms to tell COAST to use the sample parameters file. Click Open. 3. The Estimate One-time Storm Damage dialog will now be displayed. 4. Under Scenarios, select the "Tutorial" scenario created earlier. 5. In the Asset Data section, select the "Parcels" asset and click the Edit Asset... button. The Edit Assets window will be displayed. 6. In the Depth/Damage Function (DDF) section, click Use Multiple DDFs to select it and enable the Edit DDF List... button. 7. Click the Edit DDF List... button. The Edit DDF List window will be displayed. COAST Damage Assessment Tool Tutorial Page 14

15 8. In the Classification Attribute list, select "BLDG_DESC". The list under DDF by Attribute Value will be filled with all of the BLDG_DESC attribute values. 9. On the first page of attribute values, select all of the values from "ARMORY" through "BAR/LOUNGE" and then click the Select DDF... button. The Select DDF window will be displayed. 10. Select "Commercial Building" from the list, and click OK. COAST Damage Assessment Tool Tutorial Page 15

16 11. All of the selected values in the list will now have a DDF of "Commercial Building". 12. Click the OK button to save these changes, and return to the Edit Assets window. 13. Click OK to close the Edit Assets window and save the changes you made to the asset. The Estimate One-time Storm Damages window will be displayed again. 14. Click OK to run the scenario using the updated DDF information. Using Feature Styles in the COAST Viewer COAST 3.0 includes new functionality that allows you to define the styling used on asset features in the viewer. The features can all have the same style, or can have different styles depending on the value of a feature attribute. In this tutorial, we will specify different feature styles based on an attribute. Once you have set the feature style, you can choose to have that style used in the KML output file. 1. This tutorial uses a workspace that has been provided as part of the tutorial data set. 2. Open the workspace. Choose the File->Open Workspace menu item, and browse to the file: C:\CoastTutorialData\Broward\Broward.gmw. Click OK to open the workspace file. COAST Damage Assessment Tool Tutorial Page 16

17 3. Open the Layer Manager using the File->Layer Manager menu item. The Layer Manager window will be displayed. 4. Select the Broward_All.shp layer and click the Options button. The Vector Options dialog will be displayed. COAST Damage Assessment Tool Tutorial Page 17

18 5. Select the Area Styles tab. 6. Select the Apply Styling Based on Attribute/Name Values option. 7. In the list under Attribute/Name to Base Style On, choose FLD_ZONE. 8. Click the New Value button. The Select Area Style dialog will be displayed. 9. Under Fill Pattern, select Solid Fill. 10. Click the Color button next to the Fill Pattern list, and choose a color. 11. Click OK. The Enter Value for Style window will pop up. 12. Type the value AE (without quotes) and click OK. The window will close and the style and value will be displayed in the List of Values/Styles. COAST Damage Assessment Tool Tutorial Page 18

19 13. Repeat steps 8 through 12 to add styles for AH and VE. The resulting list should look like this, except that the color samples will match the colors that you have chosen: 14. Click OK to apply the styles in the COAST viewer. Note that most of the features have a FLD_ZONE of AE. In the top third of the elevation grid, you should see features that have your AH and VE styles. 15. Save the workspace to retain the style definitions. Using Asset-Specific Exceedance Curves In many cases, your scenario can use a single exceedance curve for all assets, but sometimes different assets in the same area will need to use different exceedance curves. COAST includes functionality that allows you to specify different exceedance curves based on the value of a feature attribute. This tutorial shows you how to set this up. 1. This tutorial uses a workspace that has been provided as part of the tutorial data set. 2. Open the workspace. Choose the File->Open Workspace menu item, and browse to the file: C:\CoastTutorialData\Broward\Broward.gmw. Click OK to open the workspace file. 3. Choose the Model->Run Model Scenario->Estimate One-Time Storm Damage menu item. 4. Under Asset Data, click the New Asset button. The Edit Assets dialog will be displayed. 5. Fill in the following information: Name: Parcels Map Layer: Broward_All.shp Asset Value Attribute: JUST_BUILD 6. Choose Use Multiple DDFs and click the Edit DDF List button. Fill out the Edit DDF List dialog as shown below. (See Using Multiple DDFs in a Scenario on page 14 for more information. COAST Damage Assessment Tool Tutorial Page 19

20 Though the data is different, the process is the same.) 7. Leave other fields with their default values. 8. Now, put a check next to Use Asset-Specific Exceedance Curve and click the Edit Exceedance Curve List button. The Edit Exceedance Curve List window will be displayed. 9. The process for adding exceedance curves is similar to that for multiple DDFs. First, choose ExCurve5 as the Default Exceedance Curve. 10. For the Classification Attribute, choose FLD_ZONE. The list under Exceedance Curve by Attribute Value will be automatically filled in. 11. Select the line containing the value AE and click the Select button. Choose ExCurve7 from the list on the Select Exceedance Curve dialog. COAST Damage Assessment Tool Tutorial Page 20

21 12. Repeat, using the values and exceedance curves shown below: 13. Click OK to save the exceedance curve list and close the Edit Exceedance Curve List dialog. 14. Click OK to close the Edit Assets dialog and save the new asset definition. You can an asset with exceedance curves the same way you would use any other asset. Using KML Export Styles The KML Export Style functionality in COAST allows you to customize the styling used for the damage value extrusions in the KML file output from a One-time Event Damage scenario. This tutorial will illustrate using feature styles and a color ramp. It assumes that you have already run Using Feature Styles in the COAST Viewer on page 16 and saved your workspace with the style definitions. 1. This tutorial uses a workspace that has been provided as part of the tutorial data set. 2. Open the workspace. Choose the File->Open Workspace menu item, and browse to the file: C:\CoastTutorialData\Broward\Broward.gmw. Click OK to open the workspace file. 3. Choose the Model->Run Model Scenario->Estimate One-Time Storm Damage menu item. 4. Click the Edit KML Export Style button. The KML Export Styles dialog will be displayed. 5. Under SLR and Surge Extrusions, choose Use color ramp for asset depth. 6. Select Base Color Blue and 7 for Number of Bins. The sample color ramp will update to reflect the changes. 7. Under SLR Only/Abandoned Extrusions, select Use current feature style. COAST Damage Assessment Tool Tutorial Page 21

22 8. The KML Export Styles dialog should look like this: 9. Click OK to save the export style options and close the window. 10. On the Estimate One-time Storm Damage window, click OK to run the scenario. 11. When you look at the KML output in Google Earth, you will see the extruded features in shades of blue, and the abandoned features in the color associated with the feature in the viewer. Running a Scenario Batch COAST allows you to group several scenarios into a batch and run them at one time. You can select values for several parameters, and COAST will generate a scenario for each permutation of the values and run the scenario. This tutorial illustrates how to do this with a cumulative damage scenario, but it can also be done using a one-time event damage scenario the process is the same. 1. This tutorial uses a workspace that has been provided as part of the tutorial data set. 2. Open the workspace. Choose the File->Open Workspace menu item, and browse to the file: C:\CoastTutorialData\Broward\Broward.gmw. Click OK to open the workspace file. 3. Choose the Model->Run Model Scenario->Estimate Cumulative Storm Damage menu item. 4. Use the pre-defined Broward Cumulative scenario. This scenario will provide the base values for most of the parameters. 5. Click the Run Batch button. The Run Batch window will be displayed. COAST Damage Assessment Tool Tutorial Page 22

23 6. Select one or more Exceedance Curve, Eustatic SLR Curve, and Adaptation in the lists by clicking the box to place a check mark next to the name. The names that are pre-selected are the names that are in the base scenario. You can remove those from the batch by un-checking them if necessary. 7. Enter a Time Period by typing it into the text box as <start>-<end>, separating multiple periods with commas, e.g., , Enter one or more Discount Rate(s), separated by commas, e.g., 0, In the Output Folder field, type the name of the base directory where the output will be stored. Use the Select button to browse the file system to choose a directory. 10. Once you have chosen your parameters, click the OK button to validate the choices and run the batch. 11. COAST will create an output directory for each scenario, with the name made from the parameter values specified on the Run Batch dialog. For a cumulative damages scenario, there will also be an overview of the output data created in BatchSummary.xlsx. Appendix A: Sample Model Parameter Data Editing Model Parameters The Edit Model Parameters window is used to enter and update the following types of parameter data: Exceedance curves Dynamic Exceedance curves Eustatic SLR curves Base Water Level definitions Local SLR definitions Depth/Damage Functions Adaption definitions Follow the following steps to bring up the Edit Model Parameters window: 1. Choose the Model->Edit Model Parameters File... menu item. A standard Open File dialog will be displayed. (If you are creating a new COAST parameters file, use the Model->Create Model Parameters File... menu item. In this case, a Save File dialog will be displayed.) 2. Select the COAST parameters file that you want to update, and click Open (or Save if you are creating a new file.) The COAST Model Parameters dialog will pop up. When you are finished editing model parameters, click the OK button to save your parameters and close the Edit Model Parameters window. If you click Cancel the window will be closed without saving your changes. Exceedance Curve Data An Exceedance Curve maps the probability of a storm to the expected storm surge. Each exceedance curve entry contains the following data items: COAST Damage Assessment Tool Tutorial Page 23

24 Recurrence Interval Probability Surge Height This is a textual description of how often a storm of this magnitude is expected to occur. The values defined here are used when choosing a Recurrence Interval on the Estimate One-Time Storm Damage window. A number representing the probability that a storm of this severity will happen in one year. If this is a "100 year storm", then the chance in any given year is 1%, and a probability of.01 needs to be used. This number represents the storm surge height for a storm of the specified strength. In order to enter an exceedance curve definition into a COAST Model Parameters file, you will need to do the following: 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Select the Exceedance Curves tab. 3. Click the New Curve button. The New Model Parameter dialog will be displayed. 4. Type in the name for the exceedance curve, and click OK. The Exceedance Curve tab's contents will be cleared, and the name you typed will be selected in the Exceedance Curve list. 5. If you are using the sample data below, make sure that the Unit is set to FEET ; otherwise, the vertical unit must match the unit that your storm surge height data is using. 6. Click the Add... button. The Add Line dialog will be displayed. 7. Using the table below, type in the values for Recurrence Interval, Probability, and Surge Height and click OK. 8. Repeat the previous two steps for each of the rows in the table. 9. Add another definition using the New Curve button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Here is a sample Exceedance Curve. The surge height values are in feet. Recurrence Interval Surge Height Probability 500 Y Y Y Y Y Dynamic Exceedance Curve A Dynamic Exceedance Curve is an exceedance curve where the probabilities for each surge height are allowed to vary over time. It contains the same data as an exceedance curve, but allows for multiple probabilities, each associated with a year. A dynamic exceedance curve can be used anywhere that a regular exceedance curve is used. COAST Damage Assessment Tool Tutorial Page 24

25 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Select the Dynamic Exceedance Curves tab. 3. Click the New Curve button. The New Model Parameter dialog will be displayed. 4. Type in the name for the exceedance curve, and click OK. The Dynamic Exceedance Curve tab's contents will be cleared, and the name you typed will be selected in the Dynamic Exceedance Curve list. 5. If you are using the sample data below, make sure that the Unit is set to FEET ; otherwise, the vertical unit must match the unit that your storm surge height data is using. 6. Click the Add Year button. The Add Year dialog will be displayed. 7. Type in the years you want to use, separated by commas. Using the data below, that would be, 2015,2045, Click OK. A column for each year will be added to the table. 9. Click the Add Row button. The Add Line dialog will be displayed. 10. Fill in the data for Recurrence Interval, Surge Height, and each year by clicking on the Data area for the value. Click OK. 11. Repeat for each row in the table. 12. Add another definition using the New Curve button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Here is an example Dynamic Exceedance Curve. The surge height values are in feet. Recurrence Interval Surge Height Y Y Y Y Y Eustatic Sea-Level Rise Data Eustatic SLR is the expected, world-wide sea-level rise for a specified time period. This data is typically the result of academic or industry research, such as that published by Vermeer and Rahmstorf in Each entry in a eustatic SLR curve contains: Year Sea-Level Rise The year The cumulative amount of sea-level rise expected at the specified year. In order to enter a eustatic SLR curve definition into a COAST Model Parameters file, you will need to do the following: COAST Damage Assessment Tool Tutorial Page 25

26 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Select the Eustatic SLR Curves tab. 3. Click the New Curve button. The New Model Parameter dialog will be displayed. 4. Type in the name for the eustatic SLR curve, and click OK. The Eustatic SLR Curve tab's contents will be cleared, and the name you typed will be selected in the Eustatic SLR Curve list. 5. If you are using the sample data below, make sure that the Unit is set to METERS ; otherwise, the vertical unit must match the unit that your storm surge height data is using. 6. Click the Add... button. The Add Line dialog will be displayed. 7. Using the table below, type in the values for Year and Sea-Level Rise and click OK. 8. Repeat the previous two steps for each of the rows in the table. 9. Add another definition using the New Curve button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Here is a sample Eustatic SLR Curve. The sea-level rise values are in meters. Note that this data is the high end of values estimated in Vermeer and Rahmstorf's 2009 paper. Year Sea-Level Rise Base Water Level Data Base Water Level is the value used to adjust sea level (zero elevation) to the water level used as a starting point for sea-level rise calculations. Typically, this value is derived from the mean higher high water (MHHW) or mean high tide measurement for the area in question. In order to enter a base water level definition into a COAST Model Parameters file, you will need to do the following: 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Select the Base Water Levels tab. 3. Click the New Level button. The New Model Parameter dialog will be displayed. COAST Damage Assessment Tool Tutorial Page 26

27 4. Type in the name for the base water level definition, and click OK. The Base Water Level tab's contents will be cleared, and the name you typed will be selected in the Base Water Level list. 5. If you are following the tutorial, make sure that the Unit is set to FEET ; otherwise, the vertical unit must match the unit that your storm surge height data is using. 6. Type "4.7" into the Water Level (above NAVD88) field. 7. Add another definition using the New Level button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Local SLR Data Local Sea-Level Rise is the water level increase specific to a local area, sometimes based on subsidence. In order to enter a local SLR definition into a COAST Model Parameters file, you will need to do the following: 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Select the Local Sea-Level Rise tab. 3. Click the New Local SLR button. The New Model Parameter dialog will be displayed. 4. Type in the name for the local SLR definition, and click OK. The Local SLR tab's contents will be cleared, and the name you typed will be selected in the Local SLR list. 5. If you are following the tutorial, make sure that the Unit is set to FEET ; otherwise, the vertical unit must match the unit that your storm surge height data is using. 6. Type ".00072" into the SLR per Year (above NAVD88) field. 7. Add another definition using the New Local SLR button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Depth/Damage Function Data A Depth/Damage Function (DDF) maps the flood depth to the percentage of an asset's value that is lost, i.e., the damage done to an asset. A DDF consists of the following information: Depth Damage The depth level. The damage factor, as a percentage. This asset value will be multiplied by the damage factor to calculate the asset damage. For example, if damage is 36.9%, enter In order to enter depth/damage function definition into a COAST Model Parameters file, you will need to do the following: 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Select the Depth/Damage Functions tab. 3. Click the New DDF button. The New Model Parameter dialog will be displayed. COAST Damage Assessment Tool Tutorial Page 27

28 4. Type in the name for the DDF, and click OK. The DDF tab's contents will be cleared, and the name you typed will be selected in the Depth/Damage Function list. 5. If you are using the sample DDF below, make sure that the Unit is set to FEET ; otherwise, the vertical unit needs to match the data you are entering. 6. Click the Add... button. The Add Line dialog will be displayed. 7. Using the table below, type in the values for Depth and Damage (Pct.) and click OK. 8. Repeat the previous two steps for each of the rows in the table. 9. Add another definition using the New DDF button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Here is the sample Depth/Damage Function: Depth Damage Adaptation Data An adaptation is an action that will be taken to mitigate the damages that will occur in flooding scenarios. An adaptation is represented by a DDF. You will need to enter the adaptation's DDF into the model parameters file before defining the adaptation here. The adaptation used in this tutorial is a Levee. 1. Follow the steps in Editing Model Parameters on page 23 to bring up the Edit Model Parameters window. 2. Click the Adaptations tab. COAST Damage Assessment Tool Tutorial Page 28

29 3. Click the New Adaptation button. The New Model Parameter window will be displayed. Type the name ("Levee") and click OK. The Adaptations tab will be cleared, and the new adaptation will be selected in the Adaptation list. 4. In the Cost field type " ". 5. Choose a DDF from the Depth/Damage Function list. 6. Add another definition using the New Adaptation button, click on another tab to add additional parameters, or Click OK to save the new definition and close the Edit Model Parameters window. Here is a DDF for the adaptation. This DDF assumes that the levee will protect against up to 9 feet of SLR and surge, i.e., floods of 9 feet or higher will still cause damage: Depth Damage About Blue Marble Geographics For over two decades, Blue Marble Geographics has been at the forefront of the GIS data processing software business. Pioneering work in the field of geomatics and spatial data conversion quickly established this Maine-based company as a key player in the GIS software field. Companies and organizations in every corner of the world, who appreciate the importance of maintaining the quality, integrity, and interoperability of their critical data, have come to depend on Blue Marble software. The Geographic Calculator established the benchmark for highly accurate data conversion. Employing the most extensive library of geodetic calculation parameters, this renowned software has won recognition in many fields and industries throughout the world. The power of the Geographic Calculator COAST Damage Assessment Tool Tutorial Page 29

30 is available to software developers in the GeoCalc and GeoCore SDKs and is embedded in many leading GIS and survey seismic software solutions. In addition to industry standard coordinate transformation software, Blue Marble offers Global Mapper and the Global Mapper SDK. This ever-popular GIS application is used by hundreds of thousands of GIS professionals and map enthusiasts worldwide, supports over 200 file formats, a variety of free online data sources, a 3D viewer and a digitizer tool for editing and creating geometry and attributes. The Global Mapper SDK is the basis of the COAST software tool. Blue Marble embraces and thrives on a philosophy of customer-focused product management, development, sales and most importantly support. The Blue Marble professional services team is available for training, consulting and customer software development for Blue Marble products or other leading GIS tools. Learn more at COAST Damage Assessment Tool Tutorial Page 30