National Center for Supercomputing Applications University of Illinois at Urbana-Champaign Ergo User Tutorial - Part 3 NCSA, UIUC

Web Documents GO/Ergo+Homehttps://opensource.ncsa.illinois.edu/confluence/display/ER GO/Ergo+Home

Overview Create a building dataset Ingest the dataset into Ergo Ingest a fragility curve dataset Ingest a fragility mapping dataset Explore a fragility mapping dataset

INGESTING DATASET

Creating Building Dataset (1) The development of the dataset needs to be done by using appropriate tools (i.e. QGIS, Excel, Text editor, etc.) (not by Ergo) We will create a building shapefile (GIS data) from a CSV file

Creating Building Dataset (2) Download sample data (building.zip) from attachments/ /building.zip?api=v2 attachments/ /building.zip?api=v2 Unzip the file. You will have shelby_ess.csv You can open the file by using Excel or any text editor Open QGIS Add the CSV file by select the menu: Layer – Add Layer – Add Delimited Text Layer

Creating Building Dataset (3) Select Shelby_ess.csv file Select CSV as a file format Make sure that X field is “lon” and Y field is “lat” Click OK

Creating Building Dataset (4) Leave as default when Coordinate Reference System Selector Click OK

Creating Building Dataset (5) Now, we can export the data to ESRI Shapefile Right-click on the layer and select Save As Click Browse and give a name, shelby_ess_bldg.shp Make sure CRS is EPSG:4326 Make sure Check on “Add saved file to map” Click OK

Adding a new Building Turn off the CSV layer, “shelby_ess” by click on the checkbox next to layer name

Adding a new Building (2) In order to add new building, you need to turn on “Edit” mode by clicking on “Toggle Editing” button

Adding a new Building (3) Click “Add Feature” Imaginations unbound

Adding a new Building (4) Click on where you want to add a new building on the map Then, type the information of the building as shown Click OK Imaginations unbound

Click “Toggle Editing” to finish and save your change. Click “Save” when QGIS asks to save your changes Imaginations unbound

Import Building Dataset Let’s import (ingest) the building dataset into Ergo Go to File > Import Expand Data category and select Dataset Click Next

Import Dataset – Select File Type Where it says Select One select Shapefile Click Next

Import Dataset – Select Shapefile Where it says.shp click Browse and locate shelby_ess.shp Click Next

Import Dataset – Select Data Type Where it says Select the data type for this file select Building Inventory v4 Click Next

Import Dataset – Map Attributes Leave mapping as default This dialog allows you to map fields in your dataset to fields Ergo expects to avoid modifying field names Click Next Click Next again

Import Dataset – Select Repository Where it says Repository to ingest to select Tutorial Repo Where it says Descriptive name for this dataset specify Tutorial Buildings Where it says Version number of data enter 1.0 Click Finish Drag & Drop the dataset from catalog to your scenario to see it

Exercise Create ESRI shapefile by using QGIS Import the shapefile to Ergo View the dataset on your scenario

UNDERSTANDING FRAGILITY CURVE AND MAPPING By Example

Building Attributes Building 1 Structure Type: W1 Year built: 1975 Number of Stories: 1 Building 2 Structure Type: W1 Year built: 2015 Number of Stories: 1 Building 3 Structure Type: W1 Year built: 1991 Number of Stories: 2

Fragility A Key: NSDS_PFM_MTB_U L_475_W1_3 Structure Type: W1 Code: Moderate

Fragility B Key: STR_W2_1 Structure Type: W1 Code: Pre code

Fragility C Key: STR_W1_1 Structure Type: W1 Code: Pre code

Fragility Mapping Rules Rules for Fragility A match no_stories EQ 1 year_build GE 2014 struct_typ EQ W1 Rules for Fragility B match no_stories GE 2 year_build LT 1992 struct_typ EQ W1 Rules for Fragility C match no_stories EQ 1 year_build LT 1992 struct_typ EQ W1

Fragility Mapping Building 1 Building 2 Building 3 Fragility A Fragility B Fragility C Structure Type: W1 Year built: 1975 Number of Stories: 1 Structure Type: W1 Year built: 2015 Number of Stories: 1 Structure Type: W1 Year built: 1991 Number of Stories: 2 Key: NSDS_PFM_MTB_UL_475_W1_3 Structure Type: W1 Code: Moderate Key: STR_W2_1 Structure Type: W1 Code: Pre code Key: STR_W1_1 Structure Type: W1 Code: Pre code Fragility Mapping Rules for Fragility A match no_stories EQ 1 year_build GE 2014 struct_typ EQ W1 Rules for Fragility B match no_stories GE 2 year_build LT 1992 struct_typ EQ W1 Rules for Fragility C match no_stories EQ 1 year_build LT 1992 struct_typ EQ W1 MATCHED

Fragility Mapping Building 1 Building 2 Building 3 Fragility A Fragility B Fragility C Structure Type: W1 Year built: 1975 Number of Stories: 1 Structure Type: W1 Year built: 2015 Number of Stories: 1 Structure Type: W1 Year built: 1991 Number of Stories: 2 Key: NSDS_PFM_MTB_UL_475_W1_3 Structure Type: W1 Code: Moderate Key: STR_W2_1 Structure Type: W1 Code: Pre code Key: STR_W1_1 Structure Type: W1 Code: Pre code Fragility Mapping Rules for Fragility A match no_stories EQ 1 year_build GE 2014 struct_typ EQ W1 Rules for Fragility B match no_stories GE 2 year_build LT 1992 struct_typ EQ W1 Rules for Fragility C match no_stories EQ 1 year_build LT 1992 struct_typ EQ W1 MATCHED

Fragility Mapping Building 1 Building 2 Building 3 Fragility A Fragility B Fragility C Structure Type: W1 Year built: 1975 Number of Stories: 1 Structure Type: W1 Year built: 2015 Number of Stories: 1 Structure Type: W1 Year built: 1991 Number of Stories: 2 Key: NSDS_PFM_MTB_UL_475_W1_3 Structure Type: W1 Code: Moderate Key: STR_W2_1 Structure Type: W1 Code: Pre code Key: STR_W1_1 Structure Type: W1 Code: Pre code Fragility Mapping Rules for Fragility A match no_stories EQ 1 year_build GE 2014 struct_typ EQ W1 Rules for Fragility B match no_stories GE 2 year_build LT 1992 struct_typ EQ W1 Rules for Fragility C match no_stories EQ 1 year_build LT 1992 struct_typ EQ W1 MATCHED

Fragility Mapping Building 1 Building 2 Building 3 Fragility A Fragility B Fragility C Structure Type: W1 Year built: 1975 Number of Stories: 1 Structure Type: W1 Year built: 2015 Number of Stories: 1 Structure Type: W1 Year built: 1991 Number of Stories: 2 Key: NSDS_PFM_MTB_UL_475_W1_3 Structure Type: W1 Code: Moderate Key: STR_W2_1 Structure Type: W1 Code: Pre code Key: STR_W1_1 Structure Type: W1 Code: Pre code Fragility Mapping Rules for Fragility A match no_stories EQ 1 year_build GE 2014 struct_typ EQ W1 Rules for Fragility B match no_stories GE 2 year_build LT 1992 struct_typ EQ W1 Rules for Fragility C match no_stories EQ 1 year_build LT 1992 struct_typ EQ W1

ADDING FRAGILITY CURVES

Add Fragility Curves Objective Adding new fragility curves to Ergo Content Attributes of a new fragility curve dataset How to import a new fragility curve dataset

Fragility Curve Fields ID – Simple numeric identifier, this will be used when mapping buildings to fragilities Fragility ID Code – Unique String identifier Author – author of the fragility set Structure Type – Describes the structure type of the fragility set Stories – Identifies the number of stories used for the model building Description – Brief description for the fragility curves Code – Level of seismic demand required by the building code when a model building is designed (e.g. Pre-Code)

Fragility Curve Fields (2) Damage Type – Either structural or non-structural Demand Type – Type of seismic demand (e.g. Sa, PGA, etc) Demand Unit – unit of the demand (g, %g, etc) Limit States – Limit states, delimited by “:” Period Calculation – Used to estimate the natural period of a building that the fragility curve is being applied for (see Ergo help for more information) Frag Eqn Type – 1 or 2, see Ergo help under Fragility > Buildings to understand the different equation types Parameters – Number of parameters needed to define the given fragility set (used to determine how many curves) Median/Beta Parameters – Sets of median/beta parameters for each curve, 1 parameter per column

Sample Building Fragility XML Describes multiple fragility curves Most textual fields are descriptive Take note of ID fields Numerical parameters define fragility curves Notepad++ is a good editor if you don’t have one

Import Sample Building Fragilities Download the sample fragility file at attachments/ /CustomFragility.xml?api=v2 attachments/ /CustomFragility.xml?api=v2 Go to File > Import > Data > Dataset Click Next Select Fragility Click Next Browse for the file CustomFragility.xml Click Next

Import Sample Building Fragilities (2) Select Building Fragilities Click Next Change the Equation Type dropdown to map to the FragEqnType field. Click Next again to accept he mappings Click Next again Where it says Repository to ingest to select Tutorial Repository Where it says Descriptive name for this dataset enter Tutorial Fragilities Where it says Version number of data enter 1.0 Click Finish

View Fragilities Locate the Tutorial Fragilities in your Tutorial Repository Right click on Tutorial Fragilities and select View Fragility

View Fragilities (2) Right Click > View Fragility Set Fragility View

Exercise Download the sample fragility file and open it to see how fragility is defined Import fragility file to Ergo

ADDING FRAGILITY MAPPING

Add Fragility Mapping Objective Adding new fragility mapping to Ergo to understand how fragility curves are mapped to features Content Understanding/modifying mapping format How to import a new fragility mapping

Sample Building Fragility Mapping Mapping rules determine which fragility curves to use based on details of your inventory dataset Each analysis defines multiple hardcoded keys that MUST exist Each maps to an ID defined in your fragility

Import Sample Building Fragility Mapping Download the sample fragility mapping file at attachments/ /CustomFragilityMapping.xml?api= v2 attachments/ /CustomFragilityMapping.xml?api= v2 Optionally edit the file to remove no_stories filter on the 2nd fragility Go to File > Import > Data > Dataset Click Next Select Mapping Click Next Browse for the file CustomFragilityMapping.xml Click Next

Import Sample Building Fragility Mapping (2) Select Building Fragility Mapping Click Next Where it says Repository to ingest to select Tutorial Repository Where it says Descriptive name for this dataset enter Tutorial Fragility Mapping Where it says Version number of data enter 1.0 Click Finish

View Mapping in Editor Click Window > Show View > Other > Ergo Configuration > Fragility Mapping Editor Select the fragility, fragility mapping, and shapefile that you ingested earlier

View Mapping in Editor (2) By expanding rules, you can browse through the mapping rules. In the bottom section, you can browse for a fragility to map to, by double-clicking a row in the “Fragility Key” column

Validating Fragility Mappings There is a “Fragility Mapping Test” analysis that will report errors in your mapping

Exercise Download the fragility mapping file and open it to understand the content of the file Import the fragility mapping file to Ergo Open the mapping in Ergo by using Fragility Mapping Editor and explore Run the Validation analysis Run Building Damage Analysis with your building data and built-in fragilities With your building data and imported fragilities