(optional) An array of values to plot along the x-axis. The values y(i) are plotted from x(i) to x(i+1). y
An array of values to plot along the y-axis (or the x-axis if /Horizontal is specified).
Plots a 2D bar graph that can include stacked and grouped bars, as well as various color and fill pattern options.
(optional) An array of values to plot along the x-axis. The values y(i) are plotted from x(i) to x(i+1). y
An array of values to plot along the y-axis (or the x-axis if /Horizontal is specified).
If y is a 2D array and the Stack keyword is set, then the first dimension is construed as a stack and the second dimension as a bar value.
If y is a 3D array, then the first dimension is construed as a group, the second as the stack, and the third as a bar in a stack in a group. The Stack keyword is not relevant.
Keywords
NOTE: Each of these plotting options is discussed in the Examples section.
If nonzero, a box is drawn around the legend. (Default: no box)FillColors
Specifies a 1D array of color index values. These values specify the colors with which the bars are filled. By default, the bars are filled with solid color. If either FillSpacing or FillOrientation are used, the bars are filled with lines instead of solid color. In this case, FillColors specifies the line colors. (Default: no fill color) FillLinestyle
An integer or integer array specifying the style of fill lines. If set to a scalar, all bars are filled with the same linestyle. If set to an array, the linestyle of each bar is mapped, sequentially, to the value of each array index. (Default: !P.Linestyle)
NOTE: This keyword has no effect unless either FillSpacing or FillOrientation are used.
| Index | X Windows Style | Windows Style |
|---|---|---|
| 0 | Solid | Solid |
| 1 | Dotted | Short dashes |
| 2 | Dashed | Long dashes |
| 3 | Dash dot | Long-short dashes |
| 4 | Dash-dot-dot-dot | Long-short-short dashes |
| 5 | Long dashes | Long dashes |
A floating point scalar or array specifying the orientation of fill lines, in degrees, counterclockwise from the horizontal. If set to a scalar, the orientation of fill lines in all bars is the same. If set to an array, the orientation of each bar is mapped, sequentially, to the value of each array index. (Default: Horizontal lines) FillSpacing
A floating point scalar or array specifying the space, in centimeters, between fill lines. If set to a scalar, the spacing between lines in all bars is the same. If set to an array, the spacing for each bar is mapped, sequentially, to the value of each array index. (Default: five times the value of the FillThick keyword, converted to centimeters.) FillThick
A floating point scalar or array specifying the thickness of fill lines. If set to a scalar, all bars are filled with lines of the same thickness. If set to an array, the thicknesses are mapped, sequentially, to the value of each array index. A thickness of 1 is normal, two is double-wide, and so on. (Default: !P.Thick)
NOTE: This keyword has no effect unless either FillSpacing or FillOrientation are used.
If nonzero, the y values are shown on the x-axis. If zero, the x values are shown on the y-axis. LegendBoxColor
An integer specifying the color of the legend box. LegendCharSize
A floating-point scalar specifying the size of text in the legend. (Default: 1.0). LegendLabels
An array of strings used to label individual bars. The number of strings in the array must correspond to the number of individual bars. LegendPosition
A four-element floating point array specifying the position of the legend in normal coordinates. LegendTextColor
An integer specifying the color of the text in the legend. LineColors
Specifies a 1D array of color indices. OutlineColor
An integer specifying the color index to use for the color of the outline for the bars (Default: black) Stacked
If the input array is a 2D array and the Stacked keyword is set, then the first dimension of the input array is construed as a stack and the second dimension as a bar value. See the Examples section for examples of stacked and grouped bar charts. XTickName
An array of strings specifying the names of tick marks. If the bar chart represents simple bars or stacked bars, the tick name corresponds to each one. If the bar chart represents groups of bars or stacked bars, the XTickName correspond to each group. YTickName
An array of strings, for the y-axis (or x-axis if the Horizontal keyword is specified), which specifies both the number of major tick marks (with no minor tick mark) and their labeling. Additional BAR keywords are listed below. For a description of each keyword, see Chapter 3, Graphics and Plotting Keywords, in the PV-WAVE Reference.
| [XY]Range | Noerase | [XY]Title |
| Position | Title |
Either the FillLineStyle or FillOrientation keyword (or both) must be specified to fill the bars with lines.
A stacked bar is a bar that depicts more than one value, where each value is shown on top of the previous value. A group is a set of two or more related bars appearing next to one another on the chart. It is possible to create grouped bars that are also stacked. Refer to the following examples for information on producing stacked and grouped bar charts.
The BAR2D procedure also draws bar graphs; however, it does not permit stacked and grouped bars.
; The following expressions create an array of data to plot (the ; bar values) and tick names for the x and y-axes. simple = [ 10, 20, 10, 40] XTickNames=["Quarter 1", "Quarter 2", "Quarter 3", "Quarter 4"] YTickNames=["$ 0000", "$ 1000", "$ 2000", "$ 3000"] ; ; The following expression creates a 2D array specifying data for ; four groups of bars containing three sets of bars per group. ; group1 = [ [ 100, 200, 100], [200, 150, 100], [400, 200, 100], $
[100, 110, 120]]
; ; The following expression creates a 3D array specifying data for ; two groups of bars containing three stacks with two values per ; stack. ; group2 = [ [ [10, 20], [30, 40], [100, 60]], $
[ [30, 10], [50, 50], [60, 40]]]
BAR, simple, XTickName=XTickNames, YTickName=YTickNames, $
FillOrientation=[30, 10, 0, 90], LineCol=[1,3,5,7], Outline=4, $
Fillcolors=[4, 5, 7, 1], Filllinestyle=[1,2,3,4], $
Fillthick=[1,2,3,4], $
LegendLabel=["EAST", "NORTH", "WEST", "SOUTH"], $
LegendTextColor=5, LegendCharSize=2, $
LegendPosition=[0.00, 0.3, 0.22, 0.6], $
Position=[0.3, 0.1, 0.95, 0.95], $
/Horizontal, Title="Patterned Horizontal Bar"
Figure 2-1 A horizontal bar chart with a legend. The bars are filled with colors and lines.
BAR, group1, XTickName=XTickNames, YTickName=YTickNames, $
FillOrientation=[30, 0, 90], LineCol=[1,5,7], Outline=8, $
Fillcolors=[4, 7, 1], FillLinestyle=[1,3,4], $
fillthick=[1,3,4], $
LegendLabel=["EAST", "NORTH", "SOUTH"], LegendTextColor=3, $
LegendCharSize=2, /DrawLegendBox, $
LegendPosition=[0.79, 0.7, 0.99, 0.9], $
Position=[0.1, 0.1, 0.8, 0.95], $
Title="Grouped Bars"
Figure 2-2 A bar chart with grouped bars and a legend. The bars are filled with colors and line.
BAR, group1, XTickName=XTickNames, $
FillOrientation=[30, 0, 90], LineCol=[1,5,7], Outline=8, $
filllinestyle=[1,3,4] , $
LegendLabel=["EAST", "NORTH", "SOUTH"], LegendTextColor=1, $
LegendCharSize=2.0, /DrawLegendBox,$
LegendPosition=[0.79, 0.7, 0.99, 0.9], $
Position=[0.2, 0.1, 0.8, 0.95],$
/Stacked, Title="Stacked Bars"
Figure 2-3 A bar chart with grouped and stacked bars. This plot includes a legend and line filled bars.See Also
