Node Envelope Recorder

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.

Examples

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