Child pages
  • Building Fragility
Skip to end of metadata
Go to start of metadata

Overview

This page is intended to help users get their own building fragilities into Ergo. 

 

File Types and Format

There are two acceptable formats, comma separated value (CSV) and Extensible Markup Language (XML). The simplest way to get fragilities into Ergo is the CSV format which will internally be converted to XML. Both formats will be explained in their own section after the field descriptions.

Field Descriptions

Field NameField DescriptionField TypeAcceptable ValuesInformational
IDUnique numeric identifier in the fragility datasetIntegerN/ANo
Fragility ID CodeUnique key for each fragility (e.g. SF_C1_1 for structural fragility for C1 structure type)StringN/ANo
AuthorIdentifies the person(s) who provided each fragility set.StringN/AYes
Structure TypeStructure Type this fragility curve is designed forStringN/AYes
StoriesIdentifies the number of stories used for the model building when constructing fragilities. .IntegerA value of “0” indicates multiple story levels were considered (for fragility surfaces)Yes
DescriptionA textual description providing information about the derivation of this fragility curve setStringN/AYes
Ground MotionsGround motion records used for time-history analyses when constructing fragilitiesStringN/AYes
CodeDesign code for the fragility setStringHigh-Code, Moderate-Code, Low-Code, Pre-CodeYes
Damage TypeThe type of damage type this fragility representsStringStructural, Non-StructuralYes
Demand TypeThe demand type required by the fragility, can include the period if applicable (e.g. 0.2 Sa )StringPGA, PGV, PGD, Sa, Sd, SvNo
Demand UnitThe units of the demand typeStringg, %g, etcNo
Limit StatesThe limit states which define the transitions between damage states for each fragility set.String3 limit states with a colon delimiter (e.g. Moderate: Extensive: Complete)No
T Eqn TypeEquation to estimate the natural period of a building.Integer1, 2, or 3 (see technical manual)No
T Eqn Param0First parameter to estimate natural periodDoubleN/ANo
T Eqn Param1Second parameter to estimate natural periodDoubleN/ANo
T Eqn Param2Third parameter to estimate natural periodDoubleN/ANo
Frag Eqn TypeFragility equation type.Double

1 - Lognormal distribution, 2 - Normal Distribution

No
ParametersThe number of fragility parameters (e.g. 6 if three curves with median and beta), 18 if a surface.IntegerN/A

No

Median0First fragility median valueDoubleN/ANo
Beta0First fragility beta valueDoubleN/ANo
Median1Second fragility median valueDoubleN/ANo
Beta1Second fragility beta valueDoubleN/ANo
Median2Third fragility median valueDoubleN/ANo
Beta2Third fragility beta valueDoubleN/ANo

 

In the sample fragility file, you will notice there are additional fields (e.g. FS Param 0, FS Param 1, etc). These fields are reserved for surface fragilities and can be ignored if you don't have surface fragilities. If you do have surface fragilities, see the technical manual section on "Fragility Surface Parameters" for more information. A brief description of these additional fields can be seen in the below:

Limit StateField NameField DescriptionField TypeAcceptable ValuesInformational

Limit State 1

PL1

FS Param0Surface equation parameter - α_11DoubleN/ANo
FS Param1Surface equation parameter - α_12DoubleN/ANo

FS Param2

Surface equation parameter - α_13DoubleN/ANo
FS Param3Surface equation parameter - α_14DoubleN/ANo
FS Param4Surface equation parameter - α_21DoubleN/ANo
FS Param5Surface equation parameter - α_22DoubleN/ANo

Limit State 2

PL2

FS Param6Surface equation parameter - α_11DoubleN/ANo
FS Param7Surface equation parameter - α_12DoubleN/ANo
FS Param8Surface equation parameter - α_13DoubleN/ANo
FS Param9Surface equation parameter - α_14DoubleN/ANo
FS Param10Surface equation parameter - α_21DoubleN/ANo
FS Param11Surface equation parameter - α_22DoubleN/ANo

Limit State 3

PL3

FS Param12Surface equation parameter - α_11DoubleN/ANo
FS Param13Surface equation parameter - α_12DoubleN/ANo
FS Param14Surface equation parameter - α_13DoubleN/ANo
FS Param15Surface equation parameter - α_14DoubleN/ANo
FS Param16Surface equation parameter - α_21DoubleN/ANo
FS Param17Surface equation parameter - α_22DoubleN/ANo

 

Import Sample Fragility

You can download an example CSV file with fragility data here: Ergo_Fragility_Example.csv  After downloading the sample building fragility file, follow the steps found in the Bridge Fragility example to ingest the data. The only difference will be when selecting the data type, select Building Fragilities. The rest of the steps are identical.

  • No labels