NAME

       plsurf3dl - Plot shaded 3-d surface plot for z[x][y] with y index limits

SYNOPSIS

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

DESCRIPTION

       This variant of plsurf3d(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 limits of that grid are provided  by  the  parameters
       indexxmin, indexxmax, indexymin, and indexymax.

       Redacted form: plsurf3dl(x, y, z, opt, clevel, indexxmin, indexymin, indexymax)

       This function is not used in any examples.

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 function is evaluated.

       ny (PLINT, input)
              Number of y values at which 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. FACETED + SURF_CONT opt=FACETED: Network of lines
              is  drawn connecting points at which function is defined.  opt=BASE_CONT: A contour
              plot  is  drawn  at  the  base  XY  plane  using  parameters  nlevel  and   clevel.
              opt=SURF_CONT: A contour plot is drawn at the surface plane using parameters nlevel
              and clevel.  opt=DRAW_SIDES: draws a curtain between the  base  XY  plane  and  the
              borders  of  the plotted function.  opt=MAG_COLOR: the surface is colored according
              to the value of Z; if MAG_COLOR is not  used,  then  the  default  the  surface  is
              colored  according  to  the  intensity of the reflected light in the surface from a
              light source whose position is set using pllightsource(3plplot).

       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                       PLSURF3DL(3plplot)