NAME:
PLOT2D
PURPOSE:
This routine provides a general purpose, flexible generic 2D plot
package. It provides 2D TV, SURFACE, CONTOUR, and SHADE_SURF plot.
It is very simple to use and provides various features of
adjusting 2D plot area, size, style, title, comment, etc.
The window generated by this routine will be resizable by the
window manager.
Depress the 'Print' button will generate a postscript copy of the
graph.
CATEGORY:
Widgets.
CALLING SEQUENCE:
PLOT2D, DATA, TLB, WIN
INPUTS:
DATA: The 2D array to be plotted.
KEYWORD PARAMETERS:
XARR: Set this keyword to specify the corresponding x vector values.
YARR: Set this keyword to specify the corresponding y vector values.
TITLE: Set this keyword to specify the plot title string.
XTITLE: Set this keyword to specify the xtitle string.
YTITLE: Set this keyword to specify the ytitle string.
ZTITLE: Set this keyword to specify the ztitle string.
CHARSIZE: Set this keyword to specify the plot charsize, default 1.
COMMENT: Set this keyword to write any notes on the graph.
RXLOC: Set notes X ratio to plot device width, default 0.01.
RYLOC: Set notes Y ratio to plot device height, default 0.98.
STAMP: Print the time stamp on the graph.
WTITLE: Set this keyword to specify the window title string,
default to 'Plot2d'.
WIDTH: The initial window width at the creation time, which
default to 600 pixel.
HEIGHT: The initial window height at the creation time, which
default to 450 pixel.
AX: This keyword specifies the rotated angle about the x-axis.
AX>0 toward the viewer, AX<0 away from the viewer, default
+30 degree (Surface plot)
AZ: This keyword specifies the rotated angle about the z-axis,
default 30 degree. (Surface plot)
LEGO: This keyword specifies the z value as stacked histogram
style plot. (Surface plot)
SHADE: This keyword specifies the color shade for the surface plot.
GROUP: The widget ID of the group leader of the widget. If this
keyword is specified, the death of the group leader results
in the death of PLOT2D.
OPTIONAL_OUTPUTS:
TLB: The widget ID of the top level base returned by the PLOT2D.
WIN: The window ID of the drawing area used by the PLOT2D.
COMMON BLOCKS:
COMMON PLOT2D_BLOCK plot2d_state.
SIDE EFFECTS:
The max and min value will be shown as the default comment.
RESTRICTIONS:
Fon contour plot only 12 levels is allowed.
EXAMPLES:
Create a resizable 2D plot without any title or label
specification.
PLOT2D, data
MODIFICATION HISTORY:
Written by: Ben-chin Cha, Dec 16, 1998.
12-22-1998 Add zoom in/out button to control X, Y margins
01-15-1999 Allow 5 comment lines on plot
Replace base widget MAIN13 by Plot2dMAIN13
03-05-1999 Add Plot Options support to let user set the plot
margins, title, labels, color table, various
plot style, etc.
(See plot2d.pro)