2.1.1. Inputs
The following files must be provided by the user to execute the workflow.
2.1.1.1. Configuration File
JSON file containing simulation details and specifies the application selected for each workflow step. |
||
properties |
||
|
Directory where input_data folder is located. |
|
type |
path |
|
|
Directory where applications folder is located. |
|
type |
path |
|
|
Dictionary of strings which specifiy units for force, length, and time. |
|
type |
string |
|
default |
N, m, sec |
|
|
Indicator (True/False) of which workflow outputs (EDP, DM, DV) are provided in the simulation. |
|
type |
bool |
|
default |
true |
|
|
Dictionary of applications selected for each workflow step, with their associated application-specific inputs. |
|
type |
dict |
2.1.1.2. Building Source File
CSV file containing building properties for the response simulation and damage/loss estimation steps of the workflow. This file contains all information necessary for constructing BIM files for each building asset. Required headers are grouped into categories, as follows: |
|
properties |
|
|
Headers required for all hazard types, including Earthquake/Wind/Flood. |
|
Headers only required for Wind hazards. |
|
Headers only required for Flood hazards. |
|
(Optional) Additional column headers which may be included for custom building definitions. For example, structural model parameters used in the Simulation application or alternate building classifications used in the DL application may be specified here. |
The header schema, followed by an example input, are provided. Definitions for the keywords are given in the Custom Inventory sheet.
Basic |
Basic |
Basic |
Basic |
Basic |
Basic |
Basic |
Basic |
Basic |
Basic |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Wind |
Flood |
Flood |
Flood |
Flood |
*OptionalInputs |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
id |
Longitude |
Latitude |
OccupancyClass |
BuildingType |
StructureType |
YearBuilt |
NumberofStories |
PlanArea |
ReplacementCost |
RoofShape |
RoofSlope |
RoofCover |
RoofSystem |
MeanRoofHt |
WindowArea |
Garage |
NoUnits |
DesignLevel |
DSWII |
WindZone |
AvgJanTemp |
z0 |
SplitLevel |
FirstFloorHt |
FoundationType |
FloodZone |
|
1 |
39.41770296 |
-74.50360821 |
RES1 |
3001 |
1956 |
2 |
1310.670302 |
1 |
Gable |
0 |
5701 |
Wood |
26.76835396 |
0 |
0 |
1 |
NE |
122.279935 |
I |
Above |
0.35 |
NO |
-2.97 |
3505 |
6112 |
2.1.1.3. Model File
If the simulation application chosen is OpenSees-Simulation or OpenSeesPy-Simulation, then a model file must be provided. It consists of an OpenSees/OpenSeesPy script with functions for building and analyzing a custom structural model. See the Simulation Applications page for more details on application-specific inputs. |
2.1.1.4. EDP specifications file
JSON file specifying types, locations, and directions of EDPs to record in the structural model during response simulation.The EDP specifications file is only necessary as an input if UserDefinedEDP is chosen as the EDP application. |
2.1.1.5. Event Files
To specify the type, location, and intensity of each event, the following files must be provided in the input_data/records folder. |
|||
properties |
|||
|
CSV file which specifies the coordinate (latitude/longitude) location of each event site. |
||
properties |
|||
|
Name of event file associated with the given event site. If running time history analysis, then the name of the site file is provided instead. |
||
type |
string |
||
|
Longitude coordinate of the site location. |
||
type |
float |
||
|
Latitude coordinate of the site location. |
||
type |
float |
||
|
CSV or JSON files containing information on the intensity measure of the event. |
||
properties |
|||
|
Name of ground motion record. |
||
type |
string |
||
|
Time step of ground motion recording. |
||
type |
float |
||
|
List of acceleration points in the x-direction ground motion record. |
||
type |
list |
||
|
List of acceleration points in the y-direction ground motion record. |
||
type |
list |
||
|
Value of peak ground acceleration in the x-direction ground motion record. |
||
type |
float |
||
|
Value of peak ground acceleration in the y-direction ground motion record. |
||
type |
float |
||
|
CSV files listing the names of the event file(s) assigned to the site for time history analysis. This file can also provide other properties, such as a ground motion scale factor. |
||
properties |
|||
|
Name of the ground motion event file (for Earthquake hazard events). |
||
type |
string |
||
|
Factor for scaling the ground motion. |
||
type |
float |