ElementEnvelope

The Envelope 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. When the object is terminated, through the use of a wipe, exit, or remove the object will output the min, max and absolute max values on 3 seperate lines of the output file for each quantity.

recorder EnvelopeElement < -file $fileName > < -xml $fileName > < -binary $fileName > 
  < -precision $nSD > < -time > < -closeOnWrite > < -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.

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