You are on page 1of 2

Element Recorder

The Element type records the response of a number of elements. The response recorded is element-dependent
and depends on the arguments which are passed to the setResponse() element method.

recorder Element <-file $fileName> <-time> <-ele ($ele1 $ele2 ...)> <-eleRange $startEle $endEle>
<-region $regTag> <-ele all> ($arg1 $arg2 ...)

-file output recorder data to a file

-xml output recorder data + xml metadata labelling each column of data (-
file and -xml cannot be specified symultaneously)

$filename file where results are stored. Each line of the file contains the
result for a committed state of the domain (optional, default:
screen output)

-time this argument will place the pseudo time of the as the first entry in
the line. (optional, default: omitted)

$ele1 $ele2 ... tags of elements whose response is being recorded -- selected
elements in domain (optional, default: omitted)

$startEle $endEle tag for start and end elements whose response is being recorded --
range of selected elements in domain (optional, default: all)

$regTag previously-defined tag of region of elements whose response is


being recorded -- region of elements in domain (optional)

all elements whose response is being recorded -- all elements in domain


(optional & default)

$arg1 $arg2 ... arguments which are passed to the setResponse() element method

The setResponse() element method is dependent on the element type, and is described with the element
Command.

Beam-Column Elements (Beam With Hinges Element, Displacement-Based Beam-


Column Element, Elastic Beam Column Element, Nonlinear Beam Column Element) :
Common to all beam-column elements:
globalForce – element resisting force in global coordinates (does not include inertial forces)
example:
recorder Element -file ele1global.out -time -ele 1 globalForce
localForce – element resisting force in local coordinates (does not include inertial forces)
example:
recorder Element -file ele1local.out -time -ele 1 localForce

Sections:
section $secNum – request response quantities from a specific section along the element length,
$secNum refers to the integration point whose data is to be output
force – section forces
example: recorder Element -file ele1sec1Force.out –time -ele 1 section 1 force
deformation – section deformations
example: recorder Element -file ele1sec1Defo.out –time -ele 1 section 1 deformation
stiffness – section stiffness
example: recorder Element -file ele1sec1Stiff.out –time -ele 1 section 1 stiffness
stressStrain – record stress-strain response.
example: recorder Element -file ele1sec1StressStrain.out –time -ele 1 section 1 fiber $y $z <$matID>
stressStrain

  $y local y coordinate of fiber to be monitored*

  $z local z coordinate of fiber to be monitored*

  $matID previously-defined material tag (optional)

*NOTE: The recorder object will search for the fiber closest to the location ($y,$z) on the section and record
its stress-strain response
NOTE: the ZeroLength section element only has 1 section therefore you do not need to identify the section in
the recorder command .. Example:
recorder Element -file Element1.out -time -ele 1 section 1 fiber 0.10 0.10 stressStrain
OUTPUT FORMAT
The format of the output is typically dependent on the element and/or section type. In general, however, the
output follows the order of the degrees of freedom.
Here are some cases:

element globalForce 2D, 3dof: FX FY MZ


3D, 6dof: FX FY FZ MX MY MZ

  localForce 2D, 3dof: Fx Fy Mz


3D, 6dof: Fx Fy Fz Mx My Mz

section force Fx Mx

  deformation axial-strain curvature

  stressStrain stress strain