ElementEnvelopeRecorder: Difference between revisions
No edit summary |
No edit summary |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
{| | {| | ||
| style="background: | | style="background:lime; color:black; width:830px" | '''recorder EnvelopeElement <-file $fileName> <-xml $fileName> <-binary $fileName> <-precision $nSD> <-time> <-closeOnWrite> <-ele ($ele1 $ele2 ...)> <-eleRange $startEle $endEle> <-region $regTag> $arg1 $arg2 ...''' | ||
|} | |} | ||
| Line 15: | Line 15: | ||
textual (-file option) or | textual (-file option) or | ||
binary (-binary option) | 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) | | '''-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) | | '''$ele1 $ele2 ..''' || tags of elements whose response is being recorded -- selected elements in domain (optional, default: omitted) | ||
| Line 25: | Line 30: | ||
| '''$arg1 $arg2 ...''' || arguments which are passed to the setResponse() element method | | '''$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_Command | remove recorder]] commmand. | |||
'''-1''' recorder command failed if integer '''-1''' returned. | |||
Latest revision as of 15:56, 10 October 2013
- Command_Manual
- Tcl Commands
- Modeling_Commands
- model
- uniaxialMaterial
- ndMaterial
- frictionModel
- section
- geometricTransf
- element
- node
- sp commands
- mp commands
- timeSeries
- pattern
- mass
- block commands
- region
- rayleigh
- Analysis Commands
- Output Commands
- Misc Commands
- DataBase Commands
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
Example:
recorder Element -file Element1.out -time -ele 1 3 section 1 fiber 0.10 0.10 stressStrain
Code Developed by: fmk