Download presentation
Presentation is loading. Please wait.
Published byAmi Washington Modified over 9 years ago
1
National Center for Supercomputing Applications University of Illinois at Urbana-Champaign Ergo User Tutorial - Part 3 NCSA, UIUC
2
Web Documents https://opensource.ncsa.illinois.edu/confluence/display/ER GO/Ergo+Homehttps://opensource.ncsa.illinois.edu/confluence/display/ER GO/Ergo+Home http://ergo.ncsa.illinois.edu/
3
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
4
INGESTING DATASET
5
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
6
Creating Building Dataset (2) Download sample data (building.zip) from https://opensource.ncsa.illinois.edu/confluence/download/ attachments/72975979/building.zip?api=v2 https://opensource.ncsa.illinois.edu/confluence/download/ attachments/72975979/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
7
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
8
Creating Building Dataset (4) Leave as default when Coordinate Reference System Selector Click OK
9
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
10
Adding a new Building Turn off the CSV layer, “shelby_ess” by click on the checkbox next to layer name
11
Adding a new Building (2) In order to add new building, you need to turn on “Edit” mode by clicking on “Toggle Editing” button
12
Adding a new Building (3) Click “Add Feature” Imaginations unbound
13
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
14
Click “Toggle Editing” to finish and save your change. Click “Save” when QGIS asks to save your changes Imaginations unbound
15
Import Building Dataset Let’s import (ingest) the building dataset into Ergo Go to File > Import Expand Data category and select Dataset Click Next
16
Import Dataset – Select File Type Where it says Select One select Shapefile Click Next
17
Import Dataset – Select Shapefile Where it says.shp click Browse and locate shelby_ess.shp Click Next
18
Import Dataset – Select Data Type Where it says Select the data type for this file select Building Inventory v4 Click Next
19
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
20
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
21
Exercise Create ESRI shapefile by using QGIS Import the shapefile to Ergo View the dataset on your scenario
22
UNDERSTANDING FRAGILITY CURVE AND MAPPING By Example
23
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
24
Fragility A Key: NSDS_PFM_MTB_U L_475_W1_3 Structure Type: W1 Code: Moderate
25
Fragility B Key: STR_W2_1 Structure Type: W1 Code: Pre code
26
Fragility C Key: STR_W1_1 Structure Type: W1 Code: Pre code
27
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
28
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
29
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
30
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
31
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
32
ADDING FRAGILITY CURVES
33
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
34
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)
35
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
36
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
37
Import Sample Building Fragilities Download the sample fragility file at https://opensource.ncsa.illinois.edu/confluence/download/ attachments/72975979/CustomFragility.xml?api=v2 https://opensource.ncsa.illinois.edu/confluence/download/ attachments/72975979/CustomFragility.xml?api=v2 Go to File > Import > Data > Dataset Click Next Select Fragility Click Next Browse for the file CustomFragility.xml Click Next
38
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
39
View Fragilities Locate the Tutorial Fragilities in your Tutorial Repository Right click on Tutorial Fragilities and select View Fragility
40
View Fragilities (2) Right Click > View Fragility Set Fragility View
41
Exercise Download the sample fragility file and open it to see how fragility is defined Import fragility file to Ergo
42
ADDING FRAGILITY MAPPING
43
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
44
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
45
Import Sample Building Fragility Mapping Download the sample fragility mapping file at https://opensource.ncsa.illinois.edu/confluence/download/ attachments/72975979/CustomFragilityMapping.xml?api= v2 https://opensource.ncsa.illinois.edu/confluence/download/ attachments/72975979/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
46
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
47
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
48
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
49
Validating Fragility Mappings There is a “Fragility Mapping Test” analysis that will report errors in your mapping
50
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
Similar presentations
© 2025 SlidePlayer.com. Inc.
All rights reserved.