`plot3d`: Plot 3-d surface plot
Prev | Chapter 18. The Common API for PLplot | Next

#### `plot3d`: Plot 3-d surface plot

`plot3d (` | x ,
| y ,
| z ,
| nx ,
| ny ,
| opt ,
| side `)`;

Plots a three-dimensional surface plot within the environment set up by `plw3d`. The surface is defined by the 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. The parameter ``opt`` controls the way in which the surface is displayed. For further details see the section called “Three-dimensional Plots”. The only difference between `plmesh` and `plot3d` is that `plmesh` draws the bottom side of the surface, while `plot3d` only draws the surface as viewed from the top.

`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 function is evaluated.

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

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

`opt` (``PLINT``, input)

  Determines the way in which the surface is represented:

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

`side` (``PLBOOL``, input)

  Flag to indicate whether or not ``sides'' should be draw on the figure. If ``side`` is true sides are drawn, otherwise no sides are drawn.

Redacted form: `plot3d(x, y, z, opt, side)`

This function is used in examples 11 and 21.

Prev | Up | Next
`plmtex3`: Write text relative to viewport boundaries in 3D plots | Home | `plot3dc`: Magnitude colored plot surface with contour