Node Recorder: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{CommandManualMenu}}
The Node recorder type records the response of a number of nodes at every converged step. The command to create a node recorder is:
The Node recorder type records the response of a number of nodes at every converged step. The command to create a node recorder is:


{|  
{|  
| style="background:yellow; color:black; width:800px" | ''recorder Node <-file $fileName> <-xml $fileName> <-time> <-node $node1 $node2 ...> <-nodeRange $startNode $endNode> <-region $regionTag> -dof ($dof1 $dof2 ...) $respType'''
| style="background:lime; color:black; width:800px" | ''recorder Node <-file $fileName> <-xml $fileName> <-binary $fileName> <-tcp $inetAddress $port> <-precision $nSD>  <-timeSeries $tsTag> <-time> <-dT $deltaT> <-closeOnWrite> <-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)
|  '''-time''' || (optional using this option places domain time in first entry of each data line, default is to have time ommitted)
|-
| '''inetAddr''' || ip address, "xx.xx.xx.xx", of remote machine to which data is sent
|-
| '''$port''' || port on remote machine awaiting tcp
|-
| '''$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.
|-
| '''$deltaT''' ||  time interval for recording. will record when next step is $deltaT greater than last recorder step. (optional, default: records at every time step)
|-
| '''$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)
|  '''$node1 $node2 ..''' || tags of nodes whose response is being recorded  (optional, default: omitted)
Line 38: Line 53:
|-
|-
| '''reaction''' || nodal reaction
| '''reaction''' || nodal reaction
|-
| '''rayleighForces''' || damping forces
|}
|}




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.
NOTES
* Only one of -file, -xml, -binary, -tcp will be used. If multiple specified last option is used.
* -tcp option only available for version 2.2.1 and higher.
* In case you want to remove a recorder you need to know the tag for that recorder. Here is an example on how to get the tag of a recorder:
set tagRc [recorder Node -file nodesD.out -time -node 1 2 3 4 -dof 1 2 disp]
EXAMPLES


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


EXAMPLE
Generates output file nodesD.out that contains relative displacements in x and y direction at nodes 1, 2, 3, and 4. The output file will contain 9 columns (time, disp. in x at node 1, disp. in y at node 1, ... , disp. in y at node 4))


Example:
2.
recorder Node -file nodesA.out -timeSeries 1 -time -node 1 2 3 4 -dof 1 accel;


recorder Node -file nodes.out -time -node 1 2 3 4 -dof 1 2 disp
For a UniformExcitation analysis, this command generates output file nodesA.out that contains absolute accelerations (ground motion acceleration + relative acceleration) in x direction for nodes 1, 2, 3, and 4. NOTE that if no TimeSeries is provided and a uniform excitation analysis is performed, the relative accelerations are recorded.





Latest revision as of 15:54, 10 October 2013




The Node recorder type records the response of a number of nodes at every converged step. The command to create a node recorder is:

recorder Node <-file $fileName> <-xml $fileName> <-binary $fileName> <-tcp $inetAddress $port> <-precision $nSD> <-timeSeries $tsTag> <-time> <-dT $deltaT> <-closeOnWrite> <-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)

inetAddr ip address, "xx.xx.xx.xx", of remote machine to which data is sent
$port port on remote machine awaiting tcp
$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.
$deltaT time interval for recording. will record when next step is $deltaT greater than last recorder step. (optional, default: records at every time step)
$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
rayleighForces damping forces


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.


NOTES

  • Only one of -file, -xml, -binary, -tcp will be used. If multiple specified last option is used.
  • -tcp option only available for version 2.2.1 and higher.
  • In case you want to remove a recorder you need to know the tag for that recorder. Here is an example on how to get the tag of a recorder:

set tagRc [recorder Node -file nodesD.out -time -node 1 2 3 4 -dof 1 2 disp]


EXAMPLES

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

Generates output file nodesD.out that contains relative displacements in x and y direction at nodes 1, 2, 3, and 4. The output file will contain 9 columns (time, disp. in x at node 1, disp. in y at node 1, ... , disp. in y at node 4))

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

For a UniformExcitation analysis, this command generates output file nodesA.out that contains absolute accelerations (ground motion acceleration + relative acceleration) in x direction for nodes 1, 2, 3, and 4. NOTE that if no TimeSeries is provided and a uniform excitation analysis is performed, the relative accelerations are recorded.



Code Developed by: fmk