Node Envelope Recorder

From OpenSeesWiki
Jump to navigation Jump to search




The EnvelopeNode recorder type records the min, max and absolute max of a number of nodal response quantaties. The command to create a node envelope recorder is:

recorder EnvelopeNode <-file $fileName> <-xml $fileName> <-precision $nSD> <-time> <-closeOnWrite> <-timeSeries $tsTag> <-node $node1 $node2 ...> <-nodeRange $startNode $endNode> <-region $regionTag> -dof ($dof1 $dof2 ...) $respType'

$fileName name of file to which output is sent.

file output is either in xml format (-xml option), textual (-file option) or binary (-binary option)

$nSD number of significant digits (optional, default is 6)
-time (optional using this option places domain time in first entry of each data line, default is to have time ommitted)
-closeOnWrite optional. using this option will instruct the recorder to invoke a close on the data handler after every timestep. If this is a file it will close the file on every step and then re-open it for the next step. Note, this greatly slows the execution time, but is useful if you need to monitor the data during the analysis.
$tsTag the tag of a previously constructed TimeSeries, results from node at each time step are added to load factor from series
$node1 $node2 .. tags of nodes whose response is being recorded (optional, default: omitted)
$startNode $endNode .. tag for start and end nodes whose response is being recorded (optional, default: omitted)
$regionTag a region tag; to specify all nodes in the previously defined region. (optional)
$dof1 dof2 ... the specified dof at the nodes whose response is requested.
$respType a string indicating response required. Response types are given in table below.
disp displacement*
vel velocity*
accel acceleration*
incrDisp incremental displacement
"eigen i" eigenvector for mode i
reaction nodal reaction


RETURNS

>0 an integer tag that can be used as a handle on the recorder for the remove recorder commmand.

-1 recorder command failed if integer -1 returned.


EXAMPLE

recorder EnvelopeNode -file nodesD.out -time -node 1 2 3 4 -dof 1 2 disp

recorder EnvelopeNode -file nodesA.out -time -timeSeries 1 -node 1 2 3 4 -dof 1 accel



Code Developed by: fmk