PLOT2D

The PLOT2D keyword supports a number of arguments used to simplify the task of creating plots of numeric data. This keyword makes it easy to generate surface, contour, grey scale, and false color plots.

Syntax:

PLOT2D NEW
PLOT2D TITLE, string
PLOT2D COMM1, string
PLOT2D COMM2, string
PLOT2D COMM3, string
PLOT2D COMM4, string
PLOT2D COMM5, string
PLOT2D RANGE, min, max
PLOT2D ASPECT, ratio
PLOT2D WINASPECT, type
PLOT2D DATA, arrayname
PLOT2D ACTIVECURSOR, left, right, bottom, top
PLOT2D DISPLAYTYPE, type
PLOT2D CONTOURINTERVAL, string
PLOT2D SURFACESCALE, scale
PLOT2D LOGPLOT, peak, decades
PLOT2D HIDEADDRESS, flag
PLOT2D CONFIG, configuration
PLOT2D GO
 

Discussion:

PLOT2D NEW is used to initialize a new plot. All data related to any previously generated plot2d is discarded. This should always be the first PLOT2D command used when making a new graphic.

PLOT2D TITLE is used to define the main plot title. The parameter "string" may be a literal string in quotes or may be a string variable.

PLOT2D COMMx is used to define up to 5 comments that appear on the bottom of the plot. The parameter "string" may be a literal string in quotes or may be a string variable.

PLOT2D RANGE define the minimum and maximum values of the plot. If no RANGE command is issued, a default range will be selected. The range should span the data values, or the data will be truncated to fit the range. The surface and contour plots ignore this command.

PLOT2D ASPECT defines the ratio of the x-width of the plot as compared to the y-width. The surface plots ignore this command.

PLOT2D WINASPECT defines the aspect ratio format of the window that will display the window. The valid values for type are the integers 0 through 3, which yield aspect ratios of 4x3, 5x3, 3x4, and 3x5, respectively. If no WINASPECT command is issued a default aspect ratio is used.

PLOT2D DATA is used to define the array variable containing the data to be plotted. The variable arrayname MUST be an array variables of 2 dimensions. For information on defining array variables see "Array variables". The number of points in the x and y directions is defined by the array dimensions. Any number of points is allowed, however, the minimum number of points in either direction is 5. The data will be assuming the two dimensions form a rectangular grid with uniform spacing along each dimension, although an overall aspect ratio for the plot may be defined using PLOT2D ASPECT. Only one PLOT2D DATA command may be issued.

PLOT2D ACTIVECURSOR is used to define the left, right, bottom, and top boundaries of the plotted data for display on contour, grey scale, and false color plots.

PLOT2D DISPLAYTYPE is used to select the type of plot generated. The value for type should be an integer between 1 and 6, inclusive, for surface, contour, grey scale, inverse grey scale, false color, and inverse false color, respectively.

PLOT2D CONTOURINTERVAL is used to define the contour format string. Only contour plots use this command. For details on the contour interval format string, see "The Contour Format String".

PLOT2D SURFACESCALE is used to define an overall vertical scaling of the surface plot. Only surface plots use this command. The default scaling value is 0.5 arbitrary units.

PLOT2D LOGPLOT is used to generate a log scale display. Only grey scale, inverse grey scale, false color, and inverse false color plots use this command. The peak value is an integer indicating the maximum power of 10 to plot. For example, is peak is 3, then the maximum value plotted will be 1E+03. The decades value is an integer indicating the number of log decades below the peak to plot. If peak is 3, and decades is 5, then the plot will span the range from 1.0E+03 to 1.0E-02. Note that the use of LOGPLOT does not actually take the logarithm of the input array data. The macro itself must take the log base 10 of the values in the array before calling PLOT2D GO.

PLOT2D HIDEADDRESS is used to hide or show the address data. If the flag value is zero, the address is shown, otherwise the address is not shown. See also " Address ".

PLOT2D CONFIG is used to define the configuration number shown if the address box is displayed and the address box displays information about the current configuration. If configuration is 0, the address box will show the current configuration number. If the configuration is an integer between 1 and the number of configurations, inclusive, the specific configuration number will be shown. If configuration is an integer less than 0, then "All" is shown for the configuration number.

PLOT2D GO uses all settings and data from previous PLOT2D commands and generates the desired plot, and displays the plot in a window. After the plot is generated all the PLOT2D data is reset as though PLOT2D NEW had been executed.

Related Keywords:

PLOT

Next: