2.7. EDP: Demand Parameters

This panel is where the user selects which outputs will be displayed when the simulation runs. There are a number of options available in the pull-down

  1. Standard

  2. User Defined

  3. None

2.7.1. Standard

When the user selects there are no additional inputs required. The standard EDP generator will ensure the the max absolute value of the following are obtained:

  1. Relative Floor displacements:

  2. Absolute Floor Accelerations

  3. Interstory Drifts

The results will contain results for these in abbreviated form:

  1. PFD peak relative floor displacement Event#-PFD-FLOOR-CLINE

  2. PFA peak floor acceleration Event#-PFA-FLOOR-CLINE

  3. PID peak inter-story drift: Event#-PID-STORY-CLINE

Note

Floors are numbered starting at floor 0, and stories are numbered starting at story 1.

2.7.2. User Defined

As shown in fig userEDP, this panel allows the user to determine their own output and process it. When using this option the user provides additional data:

../../../../../_images/userDefinedEDP.png

Fig. 2.7.2.1 User Defined EDP panel.

  1. Additional Input: These are additional commands that are invoked by the analysis application before the transient analysis is performed. For example, for OpenSees this would be a script containing a series of recorder commands.

A recorder file passed to OpenSees might look like the following:

# recorder EnvelopeNode -file $filename -node $nodeTag1 ... $nodeTagN -dof $DOF1 $DOF2 disp
recorder EnvelopeNode -file node.out -node 1 2 3 4 -dof 1 disp
# recorder EnvelopeElement -file $filename -ele $eleTag1 ... $eleTagN forces
recorder EnvelopeElement -file ele.out -ele 1 2 3 forces

  1. Postprocess Script: This is a python or tcl script that will be invoked

after the finite element application has run. It must be provided by the user. It’s purpose is to process the output files and create a single file, results.out. This file must contain a single line with as many entries as EDP’s specified.

For example, a python postprocessing file that would take the outputs from the recorder commands of the pervious code block to create the results file needed by the applications is illustrated as the example python file below along with the tcl script for creating recorders in OpenSees.


Warning

The name of the output file used in the post-processing script must be results.out.

  1. Response Parameters. This is an area in which the user

associates a variable name with the column of the results output file. If the process script has an array of strings named named EDP’s the script, the Response Parameters will be initially set with these values from the script.

2.7.3. None

This option is used only when the user specifies a surrogate model in the SIM tab. Because a surrogate model can evaluate only the EDPs that are pre-trained, we automatically display those quantities, and do not allow users to modify the list.

Note

This option is not for training a surrogate model but for using a pre-trained surrogate model.