Element

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

The command to create an element recorder is:

Model.recorder(“Element”, destination)

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.
recorder Element 
    < -file $fileName > < -xml $fileName > < -binary $fileName > 
    < -precision $nSD > < -time > < -closeOnWrite > < -dT $deltaT > 
    < -ele ($ele1 $ele2 ...) > < -eleRange $startEle $endEle > 
    < -region $regTag > 
    $arg1 $arg2 ...
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)

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)

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: omitted)

regTag

previously-defined tag of region of elements whose response is being recorded – region of elements in domain (optional)

arg1 arg2

arguments which are passed to the setResponse() element method

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.

NOTE:

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

EXAMPLE

Examples

recorder Element -file Element1.out -time -ele 1 3 -section 1 -fiber 0.10 0.10 stressStrain

Code Developed by: fmk