Overview
This page is intended to help users get their own bridge fragilities into MAEviz. The information you will find in this document is:
- File Types and Format
- Field Descriptions
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 MAEviz is the CSV format which will internally be changed to XML. Both formats will be explained in their own section after the field descriptions.
Field Descriptions
Where there are a limited number of possible inputs, they will be specified in the Acceptable Values column in the table below or N/A for not applicable (e.g. author would be N/A). The informational column tells you if the attribute is for informational purposes or actually used internally by MAEviz. For example, the Code column is informational and simply tells the user if the fragility was intended as a retrofit and if so, what type. The fragility mapping is what will determine which fragility gets applied to which bridge. See the Fragility Mapping documentation for more about this topic.
Field Name |
Field Description |
Field Type |
Acceptable Values |
Informational |
---|---|---|---|---|
ID |
Unique numeric identifier in the fragility dataset |
Integer |
N/A |
No |
Author |
Identifies the person(s) who provided each fragility set. |
String |
N/A |
Yes |
StructureType |
Structure Type this fragility curve is designed for |
String |
N/A |
Yes |
Description |
A textual description providing information about the derivation of this fragility curve set |
String |
N/A |
Yes |
GroundMotions |
Ground motion records used for time-history analyses when constructing fragilities |
String |
N/A |
Yes |
Code |
Design code for the fragility set |
String |
low - no retrofit, seat extender, steel jacket, Restrainer cables, Shear Key, Elastomeric Bearing |
Yes |
DamageType |
The type of damage type this fragility represents |
String |
Structural |
Yes |
DemandType |
The demand type required by the fragility, can include the period if applicable (e.g. 0.2 Sa ) |
String |
PGA, PGV, PGD, Sa, Sd, Sv |
No |
DemandUnits |
The units of the demand type |
String |
g (typically), could be other values if another demand type is specified |
No |
LimitStates |
The limit states of the fragility curves, MAEviz expects 4 limit states. This tells MAEviz how many fragility curves to expect. |
String |
Slight: Moderate: Extensive: Complete |
No |
EquationType |
The fragility equation type |
Integer |
1 - Lognormal distribution, 2 - Normal Distribution |
No |
Parameters |
The number of fragility parameters present (should be 2 parameters per fragility, median and beta) |
Integer |
N/A |
No |
After the Parameters field, specify the fragility parameters for each curve. Each curve should have a pair of parameters and the keyword for the fields are the words Median and Beta followed by a number that specifies which curve the parameter belongs to. Number should start at zero so if we have 2 fragility curves, the following 4 additional fields would be in the file:
Median0, Beta0, Median1, Beta1, Median2, Beta2, Median3, Beta3
Example CSV File
Below is a sample CSV fragility for a bridge. The first row is column names, the second row is column types (reserved for later use, but currently just ignored) and the 3rd row is a set of 4 fragility curves for an MSC_Concrete bridge.
ID |
Author |
StructureType |
Description |
GroundMotions |
Code |
DamageType |
DemandType |
DemandUnits |
LimitStates |
EquationType |
Parameters |
Median0 |
Beta0 |
Median1 |
Beta1 |
Median2 |
Beta2 |
Median3 |
Beta3 |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Int |
String |
String |
String |
String |
String |
String |
String |
String |
String |
Int |
Int |
Double |
Double |
Double |
Double |
Double |
Double |
Double |
Double |
1 |
HAZUS |
MSC_Concrete |
As-built Fragility |
Unknown |
Low |
Structural |
pga |
g |
Slight: Moderate: Extensive: Complete |
2 |
8 |
0.6 |
0.6 |
0.88 |
0.6 |
1.17 |
0.6 |
1.53 |
0.6 |
You can download the csv file here.