3.3.1.6. Plot Recorder

The Plot recorder opens a graphical window and plots columns from a text file as the analysis progresses. The input file is typically the output of another recorder (for example, a Node Recorder).

recorder Plot $fileName $windowTitle $xLoc $yLoc $xPixels $yPixels -columns $xCol $yCol <-columns $xCol2 $yCol2 ...> <-dT $deltaT> <-rTolDt $rTol>

Note

  1. At least one -columns (or -cols / -col) pair must be specified. Additional pairs may be supplied to overlay multiple curves.

  2. Column indices are 1-based. If the source recorder uses -time, column 1 is typically time.

  3. This recorder requires a build with graphics support. It is available in the Tcl interpreter; there is no direct OpenSeesPy equivalent.

  4. The only way to save the plotted image is a screen capture.

  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

The following example plots column 2 (displacement) versus column 1 (time) from a node recorder output file.

  1. Tcl Code

recorder Node -file node.out -time -node 1 -dof 2 disp
recorder Plot node.out "Nodal Displacement" 10 10 400 400 -columns 1 2

Code developed by: fmk