`plot3dcl`: Magnitude colored plot surface with contour for z[x][y] with y index limits
Prev | Chapter 18. The Common API for PLplot | Next

#### `plot3dcl`: Magnitude colored plot surface with contour for z[x][y] with y index limits

`plot3dcl (` | x ,
| y ,
| z ,
| nx ,
| ny ,
| opt ,
| clevel ,
| nlevel ,
| indexxmin ,
| indexxmax ,
| indexymin ,
| indexymax `)`;

When the implementation is completed this variant of `plot3dc` (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`.

`x` (``PLFLT_VECTOR``, input)

  A vector containing the x coordinates at which the function is evaluated.

`y` (``PLFLT_VECTOR``, input)

  A vector containing the y coordinates at which the function is evaluated.

`z` (``PLFLT_MATRIX``, input)

  A matrix containing function values to plot. Should have dimensions of `nx` by `ny`.

`nx` (``PLINT``, input)

  Number of ``x`` values at which the function is evaluated.

`ny` (``PLINT``, input)

  Number of ``y`` values at which the function is evaluated.

`opt` (``PLINT``, 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``, input)

  A vector containing the contour levels.

`nlevel` (``PLINT``, input)

  Number of elements in the `clevel` vector.

`indexxmin` (``PLINT``, input)

  The index value (which must be ≥ 0) that corresponds to the first ``x`` index where ``z`` is defined.

`indexxmax` (``PLINT``, 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``, 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``, 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``.

Redacted form:

- General: `plot3dcl(x, y, z, opt, clevel, indexxmin, indexymin, indexymax)`

- Perl/PDL: Not available?

This function is not used in any example.

Prev | Up | Next
`plot3dc`: Magnitude colored plot surface with contour | Home | `plparseopts`: Parse command-line arguments