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 used in example 8.

ARGUMENTS

       x (PLFLT_VECTOR(3plplot), input)
              A vector containing the x coordinates at which the function is evaluated.

       y (PLFLT_VECTOR(3plplot), input)
              A vector containing the y coordinates at which the function is evaluated.

       z (PLFLT_MATRIX(3plplot), input)
              A matrix containing function values to plot.  Should have dimensions of nx by ny.

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

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

       opt (PLINT(3plplot), 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  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 (PLFLT_VECTOR(3plplot), input)
              A vector containing the contour levels.

       nlevel (PLINT(3plplot), input)
              Number of elements in the clevel vector.

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

       indexxmax (PLINT(3plplot), 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 (PLINT_VECTOR(3plplot), input)
              A vector containing the 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 (PLINT_VECTOR(3plplot), input)
              A vector containing the 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.org/credits.php) have contributed to PLplot  over  its
       long history.

SEE ALSO

       PLplot documentation at http://plplot.org/documentation.php.

                                                  October, 2024                               PLSURF3DL(3plplot)