Function Reference
— Function File: bar (x, y)
— Function File: bar (y)
— Function File: bar (x, y, w)
— Function File: bar (x, y, w, style)
— Function File: h = bar (..., prop, val)
— Function File: bar (h, ...)

Produce a bar graph from two vectors of x-y data.

If only one argument is given, it is taken as a vector of y-values and the x coordinates are taken to be the indices of the elements.

The default width of 0.8 for the bars can be changed using w.

If y is a matrix, then each column of y is taken to be a separate bar graph plotted on the same graph. By default the columns are plotted side-by-side. This behavior can be changed by the style argument, which can take the values "grouped" (the default), or "stacked".

The optional return value h provides a handle to the "bar series" object with one handle per column of the variable y. This series allows common elements of the group of bar series objects to be changed in a single bar series and the same properties are changed in the other "bar series". For example

          h = bar (rand (5, 10));
          set (h(1), "basevalue", 0.5);

changes the position on the base of all of the bar series.

The optional input handle h allows an axis handle to be passed. Properties of the patch graphics object can be changed using prop, val pairs.

See also: barh plot