starvplot#

ArrayParameters.starvplot(parx='', pary='', y2='', y3='', y4='', y5='', y6='', y7='', y8='', **kwargs)#

Graphs columns (vectors) of array parameters.

Mechanical APDL Command: *VPLOT

Parameters:
parxstr

Name of the array parameter whose column vector values will be the abscissa of the graph. If blank, row subscript numbers are used instead. ParX is not sorted by the program.

parystr

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y2str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y3str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y4str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y5str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y6str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y7str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

y8str

Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

Notes

Warning

This function contains specificities regarding the argument definitions. Please refer to the command documentation for further explanations.

Argument Descriptions

  • parx : str - Name of the array parameter whose column vector values will be the abscissa of the graph. If blank, row subscript numbers are used instead. ParX is not sorted by the program.

  • pary : str - Name of the array parameter whose column vector values will be graphed against the ParX values.

  • y2, y3, y4,..., y8 : str - Additional column subscript of the ParY array parameter whose values are to be graphed against the ParX values.

The column to be graphed and the starting row for each array parameter must be specified as subscripts. Additional columns of the ParY array parameter may be graphed by specifying column numbers for Y2, Y3,…, Y8. For example, starvplot,TIME (4,6), DISP (8,1),2,3 specifies that the 1st, 2nd, and 3rd columns of array parameter DISP (all starting at row 8) are to be graphed against the 6th column of array parameter TIME (starting at row 4). The columns are graphed from the starting row to their maximum extent. See the vlen and vmask commands to limit or skip data to be graphed. The array parameters specified on the starvplot command must be of the same type (type ARRAY or TABLE; ( dim ). Arrays of type TABLE are graphed as continuous curves. Arrays of type ARRAY is displayed in bar chart fashion.

The normal curve labeling scheme for starvplot is to label curve 1 “COL 1”, curve 2 “COL 2” and so on. You can use the gcolumn command to apply user-specified labels (8 characters maximum) to your curves. See Modifying Curve Labels in the Ansys Parametric Design Language Guide for more information on using gcolumn.

When a graph plot reaches minimum or maximum y-axis limits, the program indicates the condition by clipping the graph. The clip appears as a horizontal magenta line. Mechanical APDL calculates y-axis limits automatically; however, you can modify the (YMIN and YMAX) limits via the yrange command.

This command is valid in any processor.