Node Recorder

• Command_Manual
  • Tcl Commands
  • Modeling_Commands
    • model
    • uniaxialMaterial
    • ndMaterial
    • frictionModel
    • section
    • geometricTransf
    • element
    • node
    • sp commands
      • fix
      • fixX
      • fixY
      • fixZ
    • mp commands
      • equalDOF
      • rigidDiaphragm
      • rigidLink
    • timeSeries
    • pattern
    • mass
    • block commands
      • block2D
      • block3D
    • region
    • rayleigh
  • Analysis Commands
    • constraints Command
    • numberer Command
    • system Command
    • test Command
    • algorithm Command
    • integrator Command
    • analysis Command
    • eigen Command
    • analyze Command
  • Output Commands
    • recorder
    • record
    • print
    • printA
    • logFile
    • RealTime_Output_Commands
  • Misc Commands
    • eleResponse Command
    • getTime Command
    • getEleTags Command
    • getNodeTags
    • loadConst Command
    • nodeCoord Command
    • nodeDisp Command
    • nodeVel Command
    • nodeAccel Command
    • nodeEigenvector Command
    • nodeBounds
    • print Command
    • remove Command
    • reset Command
    • testIter
    • testNorms
    • wipe Command
    • exit Command
  • DataBase Commands
    • Template:DataBaseCommandsMenu

---

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