NAME

       plot3dcl - Magnitude colored plot surface with contour for z[x][y] with y index limits

SYNOPSIS

       plot3dcl(x, y, z, nx, ny, opt, clevel, nlevel, indexxmin, indexxmax, indexymin, indexymax)

DESCRIPTION

       When the implementation is completed this variant of plot3dc(3plplot) (see that function's
       documentation for more details) should be suitable for the case where the area of the x, y
       coordinate  grid  where  z  is  defined  can  be  non-rectangular.  The  implementation is
       incomplete so the last 4 parameters of  plot3dcl;  indexxmin,  indexxmax,  indexymin,  and
       indexymax;  are  currently ignored and the functionality is otherwise identical to that of
       plot3dc(3plplot).

       Redacted form:  General: plot3dcl(x, y, z, opt, clevel, indexxmin,  indexymin,  indexymax)
       Perl/PDL: Not available?

       This function is not used in any example.

ARGUMENTS

       x (const PLFLT *, input)
              Pointer to set of x coordinate values at which the function is evaluated.

       y (const PLFLT *, input)
              Pointer to set of y coordinate values at which the function is evaluated.

       z (const PLFLT * const *, input)
              Pointer to a vectored two-dimensional array with set of function values.

       nx (PLINT, input)
              Number of x values at which the function is evaluated.

       ny (PLINT, input)
              Number of y values at which the function is evaluated.

       opt (PLINT, input)
              Determines  the  way  in which the surface is represented. To specify more than one
              option just add the options, e.g. DRAW_LINEXY + MAG_COLOR opt=DRAW_LINEX: Lines are
              drawn  showing  z as a function of x for each value of y[j].  opt=DRAW_LINEY: Lines
              are drawn showing z as a function of y for each value  of  x[i].   opt=DRAW_LINEXY:
              Network  of  lines  is  drawn  connecting  points  at  which  function  is defined.
              opt=MAG_COLOR: Each line in the mesh is colored according  to  the  z  value  being
              plotted.  The color is used from the current color map 1.  opt=BASE_CONT: A contour
              plot  is  drawn  at  the  base  XY  plane  using  parameters  nlevel  and   clevel.
              opt=DRAW_SIDES:  draws  a  curtain between the base XY plane and the borders of the
              plotted function.

       clevel (const PLFLT *, input)
              Pointer to the array that defines the contour level spacing.

       nlevel (PLINT, input)
              Number of elements in the clevel array.

       indexxmin (PLINT, input)
              The index value (which must be ≥ 0) that corresponds to the first x index  where  z
              is defined.

       indexxmax (PLINT, input)
              The  index value (which must be ≤ nx) which corresponds (by convention) to one more
              than the last x index value where z is defined.

       indexymin (const PLINT *, input)
              Array of y index values which all must be ≥ 0.  These values are the first y  index
              where  z  is  defined  for  a  particular  x  index  in the range from indexxmin to
              indexxmax - 1.  The dimension of indexymin is indexxmax.

       indexymax (const PLINT *, input)
              Array of y index values which all must  be  ≤  ny.   These  values  correspond  (by
              convention) to one more than the last y index where z is defined for a particular x
              index in the range from indexxmin to indexxmax - 1.  The dimension of indexymax  is
              indexxmax.

AUTHORS

       Many  developers  (who  are  credited  at  http://plplot.sourceforge.net/credits.php) have
       contributed to PLplot over its long history.

SEE ALSO

       PLplot documentation at http://plplot.sourceforge.net/documentation.php.

                                          February, 2014                        PLOT3DCL(3plplot)