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