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) |
|
(optional using this option places domain time in first entry of each data line, default is to have time ommitted) |
|
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
|
|
tags of elements whose response is being recorded – selected elements in domain (optional, default: omitted) |
|
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) |
|
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:
ThesetResponse()
element method is dependent on the
element type, and is described with the Element Command.
EXAMPLE
Examples
-file Element1.out -time -ele 1 3 -section 1 -fiber 0.10 0.10 stressStrain recorder Element
Code Developed by: fmk