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

  • runDir

Directory where input_data folder is located.

type

path

  • localAppDir

Directory where applications folder is located.

type

path

  • units

Dictionary of strings which specifiy units for force, length, and time.

type

string

default

N, m, sec

  • outputs

Indicator (True/False) of which workflow outputs (EDP, DM, DV) are provided in the simulation.

type

bool

default

true

  • Applications

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

  • Basic

Headers required for all hazard types, including Earthquake/Wind/Flood.

  • Wind

Headers only required for Wind hazards.

  • Flood

Headers only required for Flood hazards.

  • OptionalInputs

(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.

Table 2.1.1.1 InputDataSchema.csv

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

  • EventGrid

CSV file which specifies the coordinate (latitude/longitude) location of each event site.

properties

  • sta

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

  • lon

Longitude coordinate of the site location.

type

float

  • lat

Latitude coordinate of the site location.

type

float

  • Event IM Files

CSV or JSON files containing information on the intensity measure of the event.

properties

  • name

Name of ground motion record.

type

string

  • dT

Time step of ground motion recording.

type

float

  • data_x

List of acceleration points in the x-direction ground motion record.

type

list

  • data_y

List of acceleration points in the y-direction ground motion record.

type

list

  • PGA_x

Value of peak ground acceleration in the x-direction ground motion record.

type

float

  • PGA_y

Value of peak ground acceleration in the y-direction ground motion record.

type

float

  • Site Files

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

  • GM_file

Name of the ground motion event file (for Earthquake hazard events).

type

string

  • factor

Factor for scaling the ground motion.

type

float