Command-Driven Plotting Workflow

In the event that command-driven plotting is to be including in a modeling run, the following steps are suggested as a method for constructing the commands to be used.

  1. Construct a plot with plot items and view adjustments as needed.
  2. Export the plot to a data file.

At this point, review the exported data file and incorporate it in part or in its entirety into the command sequence under construction. If the plotting sequence is one where changes must occur (for instance, as part of a movie where the model view shifts, magnification changes, colors change, etc.), it is recommended that the desired change be made interactively, followed by export of a second data file. By comparing the exported data files, one can relatively easily identify the keywords and values associated with the modification made to the plot.

click to enlarge image in new window
click to enlarge image in new window

The images above illustrate the process. The first image shows a typical plot (this stress resultant plot comes from the example of an embedded retaining wall). The second image shows the state of the Control Panel for the plot when the “Zone Uniform” item is selected. Adjacent to that is the portion of the data file exported from the plot that contains the plot item create command that is responsible for creating the “Zone Uniform” plot item (click the image to enlarge to full resolution, if needed). There is a very close correspondence between the keywords in the command and the “Attribute” labels in the Control Panel. Accessing the command switches for plots this way is — as is the case with plotting itself — much faster than trying to construct a plot directly from reference information on the command.

Plot Data File Structure

Exported plot data files will follow a uniform structure.

  1. Commands that affect the plot as a whole are written (plot create, plot clear, etc.).
  2. Next the plot view command (or possibly commands) controlling the view appears.
  3. Last, the plot item commands that “populate” the plot are shown.

Use of indentation for the switches facilitates identification of the plot’s command structure. As can be seen when reviewing any exported plot, there are an extensive number of switches that govern the appearance of plot items. However, it is likely that only a few plot item switches will be pertinent to the user’s goals in manipulating the plot.

See also Switch/Keyword Options for lists of commonly accessed switch options (colors, line styles, etc.).

For reference, the complete exported file for the above plot is listed below.

plot create
plot clear
plot active on
plot target active on
plot background 'white'
plot outline active on width 2 color 'black'
plot legend active on heading color 'black' copyright color 'black' ...
    placement left size 25,50 ...
    step active off ...
    time-real active off ...
    time-model active off ...
    title-customer active off ...
    view-info active off
plot title-job active off
plot title active off
plot view projection perspective magnification 0.977107 ...
    center (5,2,4.9) eye (-6.37226,-11.5529,4.9) roll 0.0000 ...
    clip-front -1e+10 clip-back 1e+10
plot item create axes active on ...
    axis-x color 'black' draw-positive on draw-negative off label-positive 'X' ...
    axis-y color 'black' draw-positive on draw-negative off label-positive 'Y' ...
    axis-z color 'black' draw-positive on draw-negative off label-positive 'Z' ...
    position (0,0,0) size 1 ...
    font size 10 family 'Arial' style bold ...
    transparency 0 ...
    legend active off
plot item create structure-liner active on ...
    contour resultants ...
    ramp rainbow ...
        minimum automatic maximum automatic interval automatic ...
        reversed on above automatic below automatic resultant my surface-x (0,1,0) use-engine-data off ...
    shrink 1 ...
    map axis xyz translate (-0.01,0,0) scale (1,1,1) ...
    deformation-factor active off ...
    marker none ...
    system none ...
    polygons fill on outline active on width 1 color 'black' ...
        polygon-transparency 0 ...
        outline-transparency 80 lighting off offset 0.5 2 ...
    transparency 0 ...
    cut active off ...
    clip active off ...
    legend active on ...
        title active on text "" size 55 family 'Times New Roman' style bold color 'black' ...
        shrink-caption active off ...
        labels active on size 44 family 'Arial' style normal color 'black' ...
            labels-maximum 20 ...
        map active on size 44 family 'Arial' style normal color 'black' ...
        deformation-factor active on size 44 family 'Arial' style normal color 'black' count active off
plot item create zone active on ...
    label uniform ...
    color-list global on clear  ...
        label "Zone" color 'cyan' ...
    polygons fill on outline active on width 1 color 'black' ...
        polygon-transparency 0 ...
        outline-transparency 80 lighting on offset 0.5 2 selected-only off selected-highlight off ...
    null-faces-only off ...
    map axis xyz translate (0,0,0) scale (1,1,1) ...
    deformation-factor active off ...
    hide-null mechanical on thermal off fluid off ...
    transparency 70 ...
    cut active off ...
    clip active off ...
    legend active on ...
        title active on text "" size 55 family 'Times New Roman' style bold color 'black' ...
        map active on size 44 family 'Arial' style normal color 'black' ...
        hide-null active off ...
        deformation-factor active on size 44 family 'Arial' style normal color 'black' ...
        color-list label active on size 44 family 'Arial' style normal color 'black' ...
        heading active on text "" size 44 family 'Arial' style normal color 'black' ...
        count active off