Presentation Title

National Center for Supercomputing Applications

University of Illinois at Urbana-Champaign

Ergo User Tutorial- Part 3

NCSA, UIUC

Web Documents

•https://opensource.ncsa.illinois.edu/confluence/display/ER GO/Ergo+Home

•http://ergo.ncsa.illinois.edu/

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 byusing appropriate tools (i.e. QGIS, Excel, Text editor, etc.)(not by Ergo)

•We will create a building shapefile (GIS data) from a CSVfile

Creating Building Dataset (2)

•Download sample data (building.zip) fromhttps://opensource.ncsa.illinois.edu/confluence/download/attachments/68289024/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 selectthe menu: Layer – AddLayer – Add Delimited TextLayer

Creating Building Dataset (3)

•SelectShelby_ess.csvfile

•Select CSV as afile format

•Make sure that Xfield is “lon” andY field is “lat”

•Click OK

Creating Building Dataset (4)

•Leave as default whenCoordinate ReferenceSystem Selector

•Click OK

Adding a Building

•TODO – Jong, can you add this?

Creating Building Dataset (5)

•Now, we can export the datato ESRI Shapefile

•Right-click on the layer andselect Save As

•Click Browse and give aname, shelby_ess.shp

•Make sure CRS is EPSG:4326

•Click OK

Import Building Dataset

•Let’s import (ingest) thebuilding dataset into Ergo

•Go to File > Import

•Expand Data categoryand select Dataset

•Click Next

Import Dataset– Select File Type

•Where it says Select Oneselect Shapefile

•Click Next

Import Dataset– Select Shapefile

•Where it says .shp click Browse and locateshelby_ess.shp

•Click Next

Import Dataset– Select Data Type

•Where it says Select thedata type for this fileselect BuildingInventory v4

•Click Next

Import Dataset– Map Attributes

•Leave mapping asdefault

•This dialog allows youto map fields in yourdataset to fields Ergoexpects to avoidmodifying field names

•Click Next

•Click Next again

Import Dataset– Select Repository

•Where it says Repositoryto ingest to select TutorialRepo

•Where it says Descriptivename for this datasetspecify Tutorial Buildings

•Where it says Versionnumber of data enter 1.0

•Click Finish

•Drag & Drop the datasetfrom catalog to yourscenario to see it

Exercise

•Create ESRI shapefile by using QGIS

•Import the shapefile to Ergo

•View the dataset on your scenario

UNDERSTANDING FRAGILITYCURVE 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_UL_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

<rule>no_stories EQ 1 <rule>

<rule>year_build GE 2014</rule>

<rule>struct_typ EQ W1 </rule>

•Rules for Fragility B match

<rule>no_stories GE 2 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

•Rules for Fragility C match

<rule>no_stories EQ 1 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

Fragility Mapping

Building1

Building2

Building3

FragilityA

FragilityB

FragilityC

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

<rule>no_stories EQ 1 <rule>

<rule>year_build GE 2014</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility B match

<rule>no_stories GE 2 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility C match

<rule>no_stories EQ 1 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

MATCHED

Fragility Mapping

Building1

Building2

Building3

FragilityA

FragilityB

FragilityC

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

<rule>no_stories EQ 1 <rule>

<rule>year_build GE 2014</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility B match

<rule>no_stories GE 2 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility C match

<rule>no_stories EQ 1 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

MATCHED

Fragility Mapping

Building1

Building2

Building3

FragilityA

FragilityB

FragilityC

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

<rule>no_stories EQ 1 <rule>

<rule>year_build GE 2014</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility B match

<rule>no_stories GE 2 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility C match

<rule>no_stories EQ 1 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

MATCHED

Fragility Mapping

Building1

Building2

Building3

FragilityA

FragilityB

FragilityC

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

<rule>no_stories EQ 1 <rule>

<rule>year_build GE 2014</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility B match

<rule>no_stories GE 2 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

Rules for Fragility C match

<rule>no_stories EQ 1 <rule>

<rule>year_build LT 1992</rule>

<rule>struct_typ EQ W1 </rule>

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 whenmapping buildings to fragilities

•Fragility ID Code – Unique String identifier

•Author – author of the fragility set

•Structure Type – Describes the structure type of thefragility set

•Stories – Identifies the number of stories used for themodel building

•Description – Brief description for the fragility curves

•Code – Level of seismic demand required by the buildingcode 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 abuilding that the fragility curve is being applied for (see Ergo help formore information)

•Frag Eqn Type – 1 or 2, see Ergo help under Fragility > Buildingsto understand the different equation types

•Parameters – Number of parameters needed to define the givenfragility set (used to determine how many curves)

•Median/Beta Parameters – Sets of median/beta parameters for eachcurve, 1 parameter per column

Sample Building Fragility

•XML Describes multiplefragility curves

•Most textual fields aredescriptive

•Take note of ID fields

•Numerical parametersdefine fragility curves

•Notepad++ is a goodeditor if you don’t haveone

Import Sample Building Fragilities

•Download the sample fragility file athttps://opensource.ncsa.illinois.edu/confluence/download/attachments/68289024/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 theFragEqnType field.

•Click Next again to accept he mappings

•Click Next again

•Where it says Repository to ingest to select TutorialRepository

•Where it says Descriptive name for this dataset enterTutorial Fragilities

•Where it says Version number of data enter 1.0

•Click Finish

View Fragilities

•Locate the TutorialFragilities in yourTutorial Repository

•Right click on TutorialFragilities and selectView Fragility

View Fragilities (2)

Right Click > View Fragility Set

Fragility View

Exercise

•Download the sample fragility file and open it to see howfragility is defined

•Import fragility file to Ergo

ADDING FRAGILITY MAPPING

Add Fragility Mapping

•Objective

•Adding new fragility mapping to Ergo to understand how fragilitycurves are mapped to features

•Content

•Understanding/modifying mapping format

•How to import a new fragility mapping

Sample Building Fragility Mapping

•Mapping rules determinewhich fragility curves touse based on details ofyour inventory dataset

•Each analysis definesmultiple hardcoded keysthat MUST exist

•Each maps to an IDdefined in your fragility

Import Sample Building Fragility Mapping

•Download the sample fragility mapping file athttps://opensource.ncsa.illinois.edu/confluence/download/attachments/68289024/CustomFragilityMapping.xml?api=v2

•Optionally edit the file to remove no_stories filter on the2nd 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 TutorialRepository

•Where it says Descriptive name for this dataset enterTutorial Fragility Mapping

•Where it says Version number of data enter 1.0

•Click Finish

View Mapping in Editor

•Click Window > ShowView > Other > ErgoConfiguration >Fragility Mapping Editor

•Select the fragility,fragility mapping, andshapefile that youingested earlier

View Mapping in Editor (2)

•By expanding rules,you can browsethrough the mappingrules.

•In the bottom section,you can browse for afragility to map to, bydouble-clicking a rowin the “Fragility Key”column

Validating Fragility Mappings

•There is a “FragilityMapping Test”analysis that willreport errors in yourmapping

Exercise

•Download the fragility mapping file and open it tounderstand the content of the file

•Import the fragility mapping file to Ergo

•Open the mapping in Ergo by using Fragility MappingEditor 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