3.3.1.5. Envelope Element Recorder

The EnvelopeElement recorder tracks the minimum, maximum, and maximum absolute value of element response quantities over the analysis. The response arguments are the same as for the Element Recorder; see that page for fiber and section recording options.

recorder EnvelopeElement <-file $fileName> <-xml $fileName> <-binary $fileName> <-tcp $inetAddress $port> <-precision $nSD> <-time> <-dT $deltaT> <-rTolDt $rTol> <-closeOnWrite> <-ele $ele1 $ele2 ...> <-eleRange $startEle $endEle> <-region $regionTag> $responseArgs

Note

  1. Only one of -file, -xml, -binary, or -tcp may be used to specify the output destination.

  2. Only one of -ele, -eleRange, or -region may be used to select elements.

  3. For each recorded quantity, the output contains three values: minimum, maximum, and maximum absolute value. When -time is used, the time at which each extremum occurred is also recorded.

  4. Common beam-column response requests include globalForce, localForce, section $secNum force, section $secNum deformation, and section $secNum fiber $y $z stressStrain.

  5. The function returns a value:
    SUCCESS: >0 an integer tag that can be used as a handle to remove a recorder with the remove Command command.
    FAILURE: -1 recorder command failed (read the log)

Example

  1. Tcl Code

recorder EnvelopeElement -file ele1global.out -time -ele 1 globalForce
recorder EnvelopeElement -file ele1sec1.out -time -ele 1 section 1 force

  1. Python Code

recorder('EnvelopeElement', '-file', 'ele1global.out', '-time', '-ele', 1, 'globalForce')
recorder('EnvelopeElement', '-file', 'ele1sec1.out', '-time', '-ele', 1, 'section', 1, 'force')

Code developed by: fmk