----- file created by xop_makedoc on: Tue Oct 26 11:09:35 2004
----- Documentation for /opt/rsi/idl_6.0/lib/itools/iplot.pro -----

 NAME:
   IPLOT

 PURPOSE:
   Fire up the plot iTool.

 CALLING SEQUENCE:
   IPLOT, [[x],y] (for 2D plot)
 OR
   IPLOT, x,y,z (for 3D plot)

 INPUTS:

 KEYWORD PARAMETERS:

   SCATTER
   Set this keyword to generate a scatter plot.  This is equivalent
   to setting LINESTYLE=6 (no line) and SYM_INDEX=3 (Period symbol).

   [XYZ]ERROR
   Set this keyword to either a vector or a 2xN array of error
   values to be displayed as error bars for the [XYZ] dimension
   of the plot.  The length of this array must be equal in length
   to the number of vertices of the plot or it will be ignored.
   If the value is a vector, the value will be applied as both a
   negative and positive error and the error bar will be symmetric
   about the plot vertex.  If the value is a 2xN array the [0,*]
   values define the negative error and the [1,*] values define
   the positive error, allowing asymmetric error bars.;

   RGB_TABLE
   Set this keyword to either a 3x256 or 256x3 array containing
   color values to use for vertex colors.  Use the VERT_COLORS
   keyword to specify indices that select colors from the values
   specified with RGB_TABLE.

   VERT_COLORS
   Set this keyword to a vector of indices into the color table
   to select colors to use for vertex colors or a 3xN array of
   colors values to use directly.  If the number of indices or
   colors is less than the number of vertices, the colors are
   repeated cyclically.

 MODIFICATION HISTORY:
   Written by:  CT, RSI, March 2002
   Modified:    AY, RSI, February 2003: Update to allow 3D data


