ElementEnvelopeRecorder

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&gt; &lt;-time&gt; &lt;-closeOnWrite&gt; &lt;-ele (\)ele1 $ele2 …)> <-eleRange $startEle $endEle> <-region $regTag> $arg1 \(arg2 ...</strong></p></td> </tr> </tbody> </table> <hr /> <table> <tbody> <tr class="odd"> <td><p><code class="parameter-table-variable">fileName</code></p></td> <td><p>name of file to which output is sent. file output is either in xml format (-xml option), textual (-file option) or binary (-binary option)</p></td> </tr> <tr class="even"> <td><p><code class="parameter-table-variable">nSD</code></p></td> <td><p>number of significant digits (optional, default is 6)</p></td> </tr> <tr class="odd"> <td><p><code class="parameter-table-flag">-time</code></p></td> <td><p>(optional using this option places domain time in first entry of each data line, default is to have time ommitted)</p></td> </tr> <tr class="even"> <td><p><code class="parameter-table-flag">-closeOnWrite</code></p></td> <td><p>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.</p></td> </tr> <tr class="odd"> <td><p><strong>\)ele1 \(ele2 ..</strong></p></td> <td><p>tags of elements whose response is being recorded -- selected elements in domain (optional, default: omitted)</p></td> </tr> <tr class="even"> <td><p><strong>\)startEle \(endEle ..</strong></p></td> <td><p>tag for start and end elements whose response is being recorded -- range of selected elements in domain (optional, default: omitted)</p></td> </tr> <tr class="odd"> <td><p><code class="parameter-table-variable">regTag</code></p></td> <td><p>previously-defined tag of region of elements whose response is being recorded -- region of elements in domain (optional)</p></td> </tr> <tr class="even"> <td><p><strong>\)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

Back to top