other versions

- buster 5.14.0+dfsg-3
- testing 5.15.0+dfsg-19
- unstable 5.15.0+dfsg-19
- experimental 5.15.0+dfsg-21

PLSURF3D(3plplot) | PLplot API | PLSURF3D(3plplot) |

# NAME¶

**plsurf3d**- Plot shaded 3-d surface plot

# SYNOPSIS¶

**plsurf3d**(

*x*,

*y*,

*z*,

*nx*,

*ny*,

*opt*,

*clevel*,

*nlevel*)

# DESCRIPTION¶

Plots a three-dimensional shaded surface plot within the environment set up by**plw3d**(3plplot). The surface is defined by the two-dimensional matrix

*z*[

*nx*][

*ny*], the point

*z*[i][j] being the value of the function at (

*x*[i],

*y*[j]). Note that the points in vectors

*x*and

*y*do not need to be equally spaced, but must be stored in ascending order. For further details see the PLplot documentation.

Redacted form: **plsurf3d(x, y, z, opt, clevel)**

This function is not used in any examples.

# 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.

# 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.January, 2019 |