Scroll to navigation

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.
June, 2021