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.

                                          February, 2023                       PLSURF3DL(3plplot)