Node Envelope Recorder: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (6 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
{{CommandManualMenu}} | |||
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: | 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: | ||
{| | {| | ||
| style="background: | | style="background:lime; color:black; width:800px" | ''recorder EnvelopeNode <-file $fileName> <-xml $fileName> <-precision $nSD> <-time> <-closeOnWrite> <-timeSeries $tsTag> <-node $node1 $node2 ...> <-nodeRange $startNode $endNode> <-region $regionTag> -dof ($dof1 $dof2 ...) $respType''' | ||
|} | |} | ||
| Line 12: | Line 14: | ||
textual (-file option) or | textual (-file option) or | ||
binary (-binary option) | 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) | | '''-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 | | '''$tsTag''' || the tag of a previously constructed TimeSeries, results from node at each time step are added to load factor from series | ||
| Line 44: | Line 50: | ||
RETURNS | |||
'''>0''' an integer tag that can be used as a handle on the recorder for the [[ Remove_Command | remove recorder]] commmand. | |||
'''-1''' recorder command failed if integer '''-1''' returned. | |||
EXAMPLE | EXAMPLE | ||
recorder EnvelopeNode -file nodesD.out -time -node 1 2 3 4 -dof 1 2 disp | |||
recorder EnvelopeNode -file | recorder EnvelopeNode -file nodesA.out -time -timeSeries 1 -node 1 2 3 4 -dof 1 accel | ||
Latest revision as of 15:55, 10 October 2013
- Command_Manual
- Tcl Commands
- Modeling_Commands
- model
- uniaxialMaterial
- ndMaterial
- frictionModel
- section
- geometricTransf
- element
- node
- sp commands
- mp commands
- timeSeries
- pattern
- mass
- block commands
- region
- rayleigh
- Analysis Commands
- Output Commands
- Misc Commands
- DataBase Commands
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