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&gt; -dof (\)dof1 $dof2 …) \(respType</em>'</p></td> </tr> </tbody> </table> <hr /> <table> <tbody> <tr class="odd"> <td><p><code class="parameter-table-variable">fileName</code></p></td> <td><p>name of file to which output is sent. file output is either in xml format (-xml option), textual (-file option) or binary (-binary option)</p></td> </tr> <tr class="even"> <td><p><code class="parameter-table-variable">nSD</code></p></td> <td><p>number of significant digits (optional, default is 6)</p></td> </tr> <tr class="odd"> <td><p><code class="parameter-table-flag">-time</code></p></td> <td><p>(optional using this option places domain time in first entry of each data line, default is to have time ommitted)</p></td> </tr> <tr class="even"> <td><p><code class="parameter-table-flag">-closeOnWrite</code></p></td> <td><p>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.</p></td> </tr> <tr class="odd"> <td><p><code class="parameter-table-variable">tsTag</code></p></td> <td><p>the tag of a previously constructed TimeSeries, results from node at each time step are added to load factor from series</p></td> </tr> <tr class="even"> <td><p><strong>\)node1 \(node2 ..</strong></p></td> <td><p>tags of nodes whose response is being recorded (optional, default: omitted)</p></td> </tr> <tr class="odd"> <td><p><strong>\)startNode \(endNode ..</strong></p></td> <td><p>tag for start and end nodes whose response is being recorded (optional, default: omitted)</p></td> </tr> <tr class="even"> <td><p><code class="parameter-table-variable">regionTag</code></p></td> <td><p>a region tag; to specify all nodes in the previously defined region. (optional)</p></td> </tr> <tr class="odd"> <td><p><strong>\)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

Back to top