# view1d_overlay.pro

At APS this program is installed in the /usr/local/epics/extensions/bin/$HOST_ARCH directory. This program allows the user to overlay few different 1D scan data on the same plot. This program normally is automatically invoked by the script command viewer.

# List of Routines

- VIEW1D_OVERLAY

# Routine Descriptions

## VIEW1D_OVERLAY

[List of Routines]

     NAME:
           VIEW1D_OVERLAY

     PURPOSE:

           This program is specially written for the data catcher. It
           allows the data catcher user overlay few 1D scans on the same
           plot for a selected detector.

     CATEGORY:
    	Widgets.

     CALLING SEQUENCE:
    	VIEW1D_OVERLAY [,'filename'] [,/XDR] [,GROUP=Group]

     INPUTS:
    	None

     KEYWORD PARAMETERS:
         filename: Specifies the 1D file name to be used for displaying
                   captured 1D scan data. If not specified, the default
                   data file name 'catch1d.trashcan' is assumed.
         XDR:      Required it the input data file is in XDR platform-
                   independent binary form.
         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 VIEW1D.

     OUTPUTS:
           It uses the general purpose 1D plot plackage to overlay plot the
           selected scans. The window is resizable by the X window manager.

     COMMON BLOCKS:
           COMMON  MULTI_BLOCK, multi_ids

     SIDE EFFECTS:
           It can be invoked by the script catcher_V1D as a stand along
           program.

     RESTRICTIONS:
           Only native binary data is allowed.

     PROCEDURE:
           The path to this program must be included in the IDL search
           path.

     EXAMPLE:
           Use default setting for view1d_overlay

           	VIEW1D_OVERLAY

           Override the default setting by specifying the data file
           on the command line

           	VIEW1D_OVERLAY, 'test.dat.xdr', /XDR

     MODIFICATION HISTORY:
           Written by:     Ben-chin K. Cha, 05-27-97.

           07-25-97  bkc   Rename the catcher_view1d to view1d_overlay.
                           Add the support for XDR data format.
           12-19-97  bkc   Automatic figure out input data format
           01-15-98  bkc   Add the support of range of scans eg n1:n2 or n1-n2
           03-24-98  bkc   Allows the startup of view1d_overlay even if the index
                           file is not found

(See view1d_overlay.pro)