# plsurf3dl.3plplot - Man Page

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.