plsurf3dl - Plot shaded 3-d surface plot for z[x][y] with y
index limits
plsurf3dl(x, y, z, nx,
ny, opt, clevel, nlevel, indexxmin,
indexxmax, indexymin, indexymax)
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.
- 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.
Many developers (who are credited at
http://plplot.org/credits.php) have contributed to PLplot over its long
history.
PLplot documentation at http://plplot.org/documentation.php.