PLOT_3DBOX

The PLOT_3DBOX procedure plots a function of two variables (e.g., Z=f(X, Y) ) inside a 3D box. Optionally, the data can be projected onto the "walls" surrounding the plot area.

This routine is written in the IDL language. Its source code can be found in the file plot_3dbox.pro in the lib subdirectory of the IDL distribution.

Calling Sequence

PLOT_3DBOX, X, Y, Z

Arguments

X

A vector (i.e., a one-dimensional array) of X coordinates.

Y

A vector of Y coordinates.

Z

A vector of Z coordinates. Z[i] is a function of X[i] and Y[i] .

Keywords

GRIDSTYLE

Set this keyword to the linestyle index for the type of line to be used when drawing the gridlines. Linestyles are described in IDL Linestyles :

  • IDL Linestyles

Index

Linestyle

0

Solid

1

Dotted

2

Dashed

3

Dash Dot

4

Dash Dot Dot Dot

5

Long Dashes

PSYM

Set this keyword to an plotting symbol index to be used in plotting the data. For more information, see PSYM .

SOLID_WALLS

Set this keyword to cause the boundary "walls" of the plot to be filled with the color index specified by the COLOR keyword.

XY_PLANE

Set this keyword to plot the X and Y values on the Z=0 axis plane.

XYSTYLE

Set this keyword to the linestyle used to draw the XY plane plot. See the table above for a list of linestyles.

XZ_PLANE

Set this keyword to plot the Y and Z values on the Y=MAX( Y ) axis plane.

XZSTYLE

Set this keyword to the linestyle used to draw the XZ plane plot. See the table above for a list of linestyles.

YZ_PLANE

Set this keyword to plot the Y and Z values on the X=MAX( X ) axis plane.

YZSTYLE

Set this keyword to the linestyle used to draw the YZ plane plot. See the table above for a list of linestyles.

SURFACE Keywords

In addition to the keywords described above, the AX , AZ , and ZAXIS keywords to the SURFACE procedure are accepted by PLOT_3DBOX. See SURFACE .

Graphics Keywords Accepted

See , Graphics Keywords , for the description of graphics and plotting keywords not listed above. BACKGROUND

Example

X = REPLICATE(5., 10.) ; Create some data to be plotted.

X1 = COS(FINDGEN(36)*10.*!DTOR)*2.+5.

X = [X, X1, X]

Y = FINDGEN(56)

Z = REPLICATE(5., 10)

Z1 = SIN(FINDGEN(36)*10.*!DTOR)*2.+5.

Z = [Z, Z1, Z]

PLOT_3DBOX, X, Y, Z, /XY_PLANE, /YZ_PLANE, /XZ_PLANE, $

         /SOLID_WALLS, GRIDSTYLE=1, XYSTYLE=3, XZSTYLE=4, $

         YZSTYLE=5, AZ=40, TITLE='Example Plot Box', $

         XTITLE='X Coordinate', YTITLE='Y Coodinate', $

         ZTITLE='Z Coordinate', SUBTITLE='Sub Title', $

         /YSTYLE, ZRANGE=[0,10], XRANGE=[0,10], $

         PSYM=-4, CHARSIZE=1.6 ; Create the box plot with data projected on all of the walls. The PSYM value of -4 plots the data as diamonds connected by lines.

See Also

PLOTS , SURFACE