# plot2d.pro

At APS this program is installed in the /usr/local/epics/extensions/bin/$HOST_ARCH directory. This is a general purpose of 2D plot package.

# List of Routines

- PLOT2D

# Routine Descriptions

## PLOT2D

[List of Routines]

     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)