BAR3D Procedure

Displays a 2D grid of bars rendered three dimensionally.

Usage

BAR3D, heights

Input Parameters

heights—A 1D or 2D array of bar elevations, where heights(i,j) represents the height of the bar located at row i, column j.

Keywords

Barmin—A scalar value representing the minimum starting height of all bars. Barmin must be less then or equal to the minimum heights value, and is useful when heights values are all greater than 0 and 0 should not be included in the Z axis. By default, bars are drawn starting from a base of 0.

CenterLabels—If set and nonzero, for each column and row of bars there is a corresponding X and Y axis major tick mark which is centered with respect to each column and row.

IndividualColors—Array of the same dimensions as heights where IndividualColors(i,j) is the colortable index to associate with heights(i,j).

ColumnColors—Array of length N, where N is the number of columns in heights, where ColumnColors(i) is the colortable index to associate with the heights(*,i).

MainTitlePosition—A two element vector where MainTitlePosition(0) is X coordinate and MainTitlePosition(1) is the Y coordinate for the center of the main title, in units of a normalized coordinate system ([0,0] is the lower-left corner of the graphics window, [1,1] is the upper-right corner).

Outline—If set and nonzero, the edges of each bar are drawn in the background color (black by default).

RowColors—Array of length M, where M is the number of rows in heights, where RowColors(i) is the colortable index to associate with the heights(i,*).

Other BAR3D keywords are listed below. For a description of each keyword, see Graphics and Plotting Keywords.

Background	Linestyle	Title	[XYZ]Tickname
Charsize	Nodata	[XYZ]Charsize	[XYZ]Ticks
Charthick	Noerase	[XYZ]Gridstyle	[XYZ]Tickv
Color	Noshade	[XYZ]Margin	[XYZ]Title
Data	Normal	[XYZ]Minor	YLabelCenter
Device	Position	[XYZ]Range	ZAxis
Font	Subtitle	[XYZ]Style	ZValue
Gridstyle	Thick	[XYZ]Thick
Horizontal	Ticklen	[XYZ]Ticklen

Discussion

The heights parameter is a 1D or 2D array of elevation values. The 3D effect is established by modifying the colortable to create darker color values for use on the top and left sides of the bars. By default, the bars are displayed vertically (upward).

Examples

WINDOW, /Free, Xsize=800, Ysize=600, Title='PLOT and BAR3D'
!P.Multi = [0,2,0]
PLOT, INDGEN(10), Title='Some Plot'
xlabels = ['One', 'Two', 'Three', 'Four', 'Five']
ylabels = ['E', 'D', 'C', 'B', 'A']
xx = DIST(5) * RANDOMU(seed, 5, 5) * 2 + 0.5
LOADCT, 0
TEK_COLOR
; Make a 5x5 array of random colortable indices, ranging 2-31
randColors = NINT(RANDOMU(s, 5, 5)*29 + 2)
BAR3D, xx, Ax=75, Az=15, Title='Crop Yield Analysis', $
   Xtitle='Plot Column', Xtickname=xlabels, Ytitle='Plot Row', $
   Ytickname=ylabels, /CenterLabels, $
   Ztitle='Seed Germination', Charsize=1.15, /Outline, Font=0, $
   IndividualColors=randColors, Ticklen=-0.05, $
   MainTitlePosition=[0.75, 0.95]

BAR3D Output