Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]

PLOT_3DBOX


Syntax | Arguments | Keywords | Examples | Version History | See Also

The PLOT_3DBOX procedure plots a function of two variables (e.g., Z=f(X, Y)) inside a 3-D 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.

Syntax

PLOT_3DBOX, X, Y, Z [, GRIDSTYLE={0 | 1 | 2 | 3 | 4 | 5}] [, PSYM=integer{1 to 10}] [, /SOLID_WALLS] [, /XY_PLANE] [, XYSTYLE={0 | 1 | 2 | 3 | 4 | 5}] [, /XZ_PLANE] [, XZSTYLE={0 | 1 | 2 | 3 | 4 | 5}] [, /YZ_PLANE] [, YZSTYLE={0 | 1 | 2 | 3 | 4 | 5}] [, AX=degrees] [, AZ=degrees] [, ZAXIS={1 | 2 | 3 | 4}]

Graphics Keywords: Accepts all graphics keywords accepted by PLOT except for: FONT, PSYM, SYMSIZE, {XYZ}TICK_GET, and ZVALUE.

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 the following table:

Index
Linestyle
0
Solid
1
Dotted
2
Dashed
3
Dash Dot
4
Dash Dot Dot
5
Long Dashes

PSYM

Set this keyword to a 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, CHARSIZE, CHARTHICK, CLIP, COLOR, DATA, DEVICE, LINESTYLE, NOCLIP, NOERASE, NORMAL, POSITION, SUBTITLE, T3D, THICK, TICKLEN, TITLE, [XYZ]CHARSIZE, [XYZ]GRIDSTYLE, [XYZ]MARGIN, [XYZ]MINOR, [XYZ]RANGE, [XYZ]STYLE, [XYZ]THICK, [XYZ]TICKFORMAT, [XYZ]TICKLEN, [XYZ]TICKNAME, [XYZ]TICKS, [XYZ]TICKV, [XYZ]TITLE.

Examples

; Create some data to be plotted: 
X = REPLICATE(5., 10.) 
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] 
 
; 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: 
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 

Version History

Introduced: Pre 4.0

See Also

IPLOT, PLOTS, SURFACE


Categories | Alphabetical | Classes | All Contents | [ < ] | [ > ]