2.3.4. Modeling Applications¶

The modeling application consolidates information on the structural analysis model (SAM) used to represent the building on each site. It takes as input the BIM file, the EVENT file, and information on the structural model used for response simulation, specified in the configuration file. The input structural model information is parsed into a SAM.json file, located in its corresponding simulation working directory.

../../../../../_images/backendapps_Modeling.png

bknd-0019

MDOF-LU

Creates SAM.json file and generates script for creating a hysteretic multi-degree of freedom (MDOF) system subject to earthquake time history analysis, based on the Lu method. Analysis is executed by the OpenSeesSimulation application.

Inputs

CLI

BIM file <string>: File containing a dictionary of building information.
EVENT file <string>: File containing event intensity measure for each simulation per building.
HAZUS data <path>: Defines location of the HAZUS building configuration file.
stdStiffness <float>: Defines the standard deviation that should be considered when sampling the stiffness for the building.
stdDamping <float>: Defines the standard deviation that should be considered when sampling the damping ratio for the building.

bknd-0020

OpenSeesInput

Creates SAM.json file containing model information for an input OpenSees structural model. Analysis is executed in the OpenSeesSimulation application.

Inputs

CLI

filenameBIM <FileName(r)>: name of bim file
filenameEVENT <FileName(r)>: name of file containing the event data
filenameSAM <FileName(w)>: name of file containing the outputted SAM

bknd-0021

OpenSeesPyInput

Creates SAM.json file containing model information for an input OpenSeesPy structural model. The functions 'build_model' and 'run_analysis' must be defined in the model script. Analysis is executed in the OpenSeesPySimulation application.

Inputs

CLI

filenameBIM <string>: File containing a dictionary of building information.
filenameEVENT <string>: File containing event intensity measure for each simulation per building.
modelPath <FileName(r)>: Defines the location of the input OpenSeesPy model files.
mainScript <FileName(r)>: Defines the name of the main model file which contains the build_model and run_analysis functions.
ndm <string>: Defines the number of degrees of freedom in the numerical model.
dofMap <int>: By default, the workflow assumes X=1, Y=2, Z=3 mapping between directions and degrees of freedom, with XY being the horizontal directions. This input allows you to define an alternative mapping by providing three numbers separated by commas in a string, such as '1, 3, 2' if you wish to have Y as the vertical direction.
ctrlNodes <string>: Defines the IDs of nodes in the OpenSeesPy model where EDPs are recorded. If the number of ctrlNodes provided exceeds the number of stories, only the firsts n+1 nodes will be used for an n-story building.
filenameSAM <FileName(w)>: File containing model information for response simulation.


                usage: OpenSeesPyInput.py [-h] [--filenameBIM FILENAMEBIM]
                          [--filenameEVENT FILENAMEEVENT]
                          [--filenameSAM FILENAMESAM]
                          [--mainScript MAINSCRIPT] [--modelPath MODELPATH]
                          [--ndm NDM] [--dofMap DOFMAP] [--getRV [GETRV]]

optional arguments:
  -h, --help            show this help message and exit
  --filenameBIM FILENAMEBIM
  --filenameEVENT FILENAMEEVENT
  --filenameSAM FILENAMESAM
  --mainScript MAINSCRIPT
  --modelPath MODELPATH
  --ndm NDM
  --dofMap DOFMAP
  --getRV [GETRV]

bknd-0022

MDOF_BuildingModel

No description

Inputs

CLI

filenameBIM <FileName(r)>: name of bim file
filenameEVENT <FileName(r)>: name of file containing the event data
filenameSAM <FileName(w)>: name of file containing the outputted SAM