Element Recorder: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by one other user not shown)
Line 6: Line 6:


{|  
{|  
| style="background:lime; color:black; width:770px" | '''recorder Element <-file $fileName> <-xml $fileName> <-binary $fileName> <-precision $nSD> <-time> <-dT $deltaT> <-ele ($ele1 $ele2 ...)> <-eleRange $startEle $endEle> <-region $regTag>  $arg1 $arg2 ...'''
| style="background:lime; color:black; width:770px" | '''recorder Element <-file $fileName> <-xml $fileName> <-binary $fileName> <-precision $nSD> <-time> <-closeOnWrite> <-dT $deltaT> <-ele ($ele1 $ele2 ...)> <-eleRange $startEle $endEle> <-region $regTag>  $arg1 $arg2 ...'''
|}
|}


Line 21: Line 21:
|  '''-time''' || (optional using this option places domain time in first entry of each data line, default is to have time ommitted)
|  '''-time''' || (optional using this option places domain time in first entry of each data line, default is to have time ommitted)
|-
|-
| '''-dT $deltaT''' || optional. time interval for recording, will record when next step is $deltaT greater than last recorder step. by default records at every time step.
| '''-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)
|  '''$ele1 $ele2 ..''' || tags of elements whose response is being recorded -- selected elements in domain  (optional, default: omitted)

Latest revision as of 15:55, 10 October 2013




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:

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

Example:

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



Code Developed by: fmk