bar3 (z) plots 3D bar graph for the elements of z. Each bar corresponds to an element in z, which can be a scalar, vector, or 2D matrix. By default, each column in z is considered as a series and it is handled as a distinct series of bars. When z is a vector, unlike MATLAB, which plots it as a single series of bars, Octave discriminates between a row and column vector of z. Hence, when z is column vector, it is plotted as a single series of bars (same color), whereas when z is row vector, each bar is plotted as a different group (different colors). For an $M\times N$ matrix, the function plots the bars corresponding to each row on the y-axis ranging from $1$ to $M$ and each column on the x-axis ranging from $1$ to $N$.

bar3 (y, z) plots a 3D bar graph of the elements in z at the y-values specified in y. It should be noted that y only affects the tick names along the y-axis rather the actual values. If you want to specify non-numerical values for y, you can specify it with the paired name/value syntax shown below.

bar3 (…, width) sets the width of the bars along the x- and y-axes and controls the separation of bars among each other. width can take any value in the range $(0,1]$. By default, width is 0.8 and the bars have a small separation. If width is 1, the bars touch one another. Alternatively, you can define width as a two- element vector using the paired name/value syntax shown below, in which case you can control the bar separation along each axis independently.

bar3 (…, style) specifies the style of the bars, where style can be 'detached', 'grouped', or 'stacked'. The default style is @code {’detached’.

bar3 (…, color displays all bars using the color specified by color. For example, use 'red' or 'red' to specify all red bars. When you want to specify colors for several groups, color can be a cellstr vector with each element specifying the color of each group. color can also be specified as a numerical $M\times 3$ matrix, where each row corresponds to a RGB value with its elements in the range $[0,1]$. If only one color is specified, then it applies to all bars. If the number of colors equals the number of groups, then each color is applied to each group. If the number of colors equals the number of elements in z, then each inidividual bar is assigned the particular color. You can also define color using the paired name/value syntax shown below.

bar3 (…, name, value) specifies one or more of the following name/value pairs:

bar3 (ax, …) can also take an axes handle ax as a first argument in which case it plots into the axes specified by ax instead of into the current axes specified by gca (). The optional argument ax can precede any of the input argument combinations in the previous syntaxes.

p = bar3 (…) returns a patch handle p, which can be used to set properties of the bars after displaying the 3D bar graph.

See also: boxplot, hist3

Source Code: bar3