bar3h
Threedimensional horizontal bar plot.
bar3h(x)
bar3h(x,options)
bar3h(x,y)
bar3h(x,y, options)
Inputs 
x 
An array of real numbers. 
y 
An array of real numbers. 
Outputs 
options 
A set of options to control the appearance of the plot. One of the options may be specified as the
string 'stacked' or 'grouped' for stacking or grouping
multiple bars. The other option may be used to
specify the width of the plot in the form of a pair 'width', w , where
w is the width parameter, a number between 0 and 1 .

Description
If x
is a onedimensional array, bar3h(x)
displays horizontal
hexadra in the xz plane with rectangular faces (threed bars)
at the points [1,2,..n]
along the zaxis, where n
is the number of elements
in x
. The width of the bars is proportional to the
magnitudes of the elements of x
.
If x
has m
columns, bar3h(x)
displays m
rows
horizontal
bars, the other at each of the points
[1,2,..n]
where n
is the number of rows in x
, with each row
located along the third dimension (yaxis).
If one of the options
is the string 'stacked'
or 'grouped'
,
all the bars are placed in a single row, with the bars at
each point [1,...n]
stacked vertically one over the other or
placed side by side
with the heights of the bars determined by the
elements in a given row of x
.
The distance between the bars at adjoining points on the zaxis
can be controlled by specifying the width parameter in the input
options
. If width is specified to be one, there is no gap between
the bars at various points, and if it is zero, bars are
displayed with maximum possible gaps between them. Intermediate values
of the width parameter control the width of gaps accordingly.
In the call bar3h(x, y)
, the height of the bars is specified by the
elements of y
, and elements of x
are used
for the locations of the bars along the xaxis. The inputs
specified in options
control the
gap size and the type of grouping of bars just as for the
call bar3h(x)
.
Example
>>subplot(2,2,1)
>>bar3h(rand(4,2))
>>title("Bar Plot")
>>subplot(2,2,2)
>>bar3h(rand(4,3),'grouped')
>>title("Grouped Bar Plot")
>>subplot(2,2,3)
>>bar3h(rand(4,3),'stacked')
>>title("Stacked Bar Plot")
>>subplot(2,2,4)
>>bar3h(rand(4,2),'width',.3)
>>title("Bar Plot with Specified Fractional Width")