Node

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

Model.recorder(“Node”, destination, recorder)

destination str

precision int number of significant digits (default is 6)(optional, default: records at every time step)

time = False bool using this option places domain time in first entry of each data line, default is to have time omitted

closeOnWrite = False bool 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.

time_step float time interval for recording. will record when next step is deltaT greater than last recorder step.

series Ref(TimeSeries) the tag of a previously constructed TimeSeries, results from node at each time step are added to load factor from series

nodes

[nodes1], tags of nodes whose response is being recorded (optional, default: omitted)

nodes1 Ref(node)

dofs

[dofs], the specified dof at the nodes whose response is requested.

dofs int

recorder

str

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

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), plain text (`-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

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))
```
recorder Node -file nodesD.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.
```
recorder Node -file nodesA.out -timeSeries 1 -time -node 1 2 3 4 -dof 1 accel;
```

Code Developed by: fmk