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

PLOT3DCL(3plplot) | PLplot API | PLOT3DCL(3plplot) |

# NAME¶

**plot3dcl**- Magnitude colored plot surface with contour for z[x][y] with y index limits

# SYNOPSIS¶

**plot3dcl**(

*x*,

*y*,

*z*,

*nx*,

*ny*,

*opt*,

*clevel*,

*nlevel*,

*indexxmin*,

*indexxmax*,

*indexymin*,

*indexymax*)

# DESCRIPTION¶

When the implementation is completed this variant of**plot3dc**(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 implementation is incomplete so the last 4 parameters of plot3dcl;

*indexxmin*,

*indexxmax*,

*indexymin*, and

*indexymax*; are currently ignored and the functionality is otherwise identical to that of

**plot3dc**(3plplot).

Redacted form: General: **plot3dcl(x, y, z, opt, clevel,
indexxmin, indexymin, indexymax) **

This function is not used in any example.

# 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 the function is evaluated. *ny*(**PLINT**(3plplot), input)- Number of
*y*values at which the 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. DRAW_LINEXY + MAG_COLOR
*opt*=DRAW_LINEX : Lines are drawn showing*z*as a function of*x*for each value of*y*[j] .*opt*=DRAW_LINEY : Lines are drawn showing*z*as a function of*y*for each value of*x*[i] .*opt*=DRAW_LINEXY : Network of lines is drawn connecting points at which function is defined.*opt*=MAG_COLOR : Each line in the mesh is colored according to the z value being plotted. The color is used from the current cmap1.*opt*=BASE_CONT : A contour plot is drawn at the base XY plane using parameters*nlevel*and*clevel*.*opt*=DRAW_SIDES : draws a curtain between the base XY plane and the borders of the plotted function. *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
*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
*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.January, 2019 |