# surface¶

## Purpose¶

Graphs a 3-D surface.

Note

This function is for use with the deprecated PQG graphics. Use plotSurface() instead.

pgraph

## Format¶

surface(x, y, z)
Parameters: x (1xK vector) – the x-axis data. y (Nx1 vector) – the y-axis data. z (NxK matrix) – the matrix of height data to be plotted.

## Global Input¶

\_psurf

2x1 vector, controls 3-D surface characteristics.

: if 1, show hidden lines. Default 0. color for base (default 7). The base is an outline of the X-Y plane with a line connecting each corner to the surface. If 0, no base is drawn.
\_pticout

scalar, if 0 (default), tick marks point inward, if 1, tick marks point outward.

\_pzclr

Z level color control.

There are 3 ways to set colors for the Z levels of a surface graph.

1. To specify a single color for the entire surface plot, set the color

control variable to a scalar value 1-15. For example:

_pzclr = 15;

2. To specify multiple colors distributed evenly over the entire Z range,

set the color control variable to a vector containing the desired colors only. GAUSS will automatically calculate the required corresponding Z values for you. The following example will produce a three color surface plot, the Z ranges being lowest=blue, middle=light blue, highest=white:

_pzclr = { 1, 10, 15 };

3. To specify multiple colors distributed over selected ranges, the Z

ranges as well as the colors must be manually input by the user. The following example assumes -0.2 to be the minimum value in the z matrix:

_pzclr = { -0.2 1,
/* z >= -0.2 blue */
0.0 10,
/* z >= 0.0 light blue */
0.2 15 };
/* z >= 0.2 white */


Since a Z level is required for each selected color, the user must be responsible to compute the minimum value of the z matrix as the first Z range element. This may be most easily accomplished by setting the _pzclr matrix as shown above (the first element being an arbitrary value), then resetting the first element to the minimum z value as follows:

_pzclr = { 0.0 1,
0.0 10,
0.2 15 };
_pzclr[1,1] = minc(minc(z));


See PQG Graphics Colors, for the list of available colors.

## Remarks¶

surface() uses only the minimum and maximum of the x-axis data in generating the graph and tick marks.

psurface.src