Make a horizontal bar plot.
The bars are positioned at y with the given alignment. Their dimensions are given by width and height. The horizontal baseline is left (default 0).
Many parameters can take either a single value applying to all bars or a sequence of values, one for each bar.
The y coordinates of the bars. See also align for the alignment of the bars to the coordinates.
Bars are often used for categorical data, i.e. string labels below the bars. You can provide a list of strings directly to y. barh(['A', 'B', 'C'], [1, 2, 3]) is often a shorter and more convenient notation compared to barh(range(3), [1, 2, 3], tick_label=['A', 'B', 'C']). They are equivalent as long as the names are unique. The explicit tick_label notation draws the names in the sequence given. However, when having duplicate values in categorical y data, these values map to the same numerical y coordinate, and hence the corresponding bars are drawn on top of each other.
The width(s) of the bars.
Note that if left has units (e.g. datetime), width should be in units that are a difference from the value of left (e.g. timedelta).
The heights of the bars.
Note that if y has units (e.g. datetime), then height should be in units that are a difference (e.g. timedelta) around the y values.
The x coordinates of the left side(s) of the bars.
Note that if left has units, then the x-axis will get a Locator and Formatter appropriate for the units (e.g. dates, or categorical).
Alignment of the base to the y coordinates*:
'center': Center the bars on the y positions.
'edge': Align the bottom edges of the bars with the y positions.
To align the bars on the top edge pass a negative height and align='edge'.
BarContainer
Container with all the bars and optionally errorbars.
The colors of the bar faces.
The colors of the bar edges.
Width of the bar edge(s). If 0, don't draw edges.
The tick labels of the bars. Default: None (Use default numeric labels.)
A single label is attached to the resulting BarContainer as a label for the whole dataset. If a list is provided, it must be the same length as y and labels the individual bars. Repeated labels are not de-duplicated and will cause repeated label entries, so this is best used when bars also differ in style (e.g., by passing a list to color.)
If not None, add horizontal / vertical errorbars to the bar tips. The values are +/- sizes relative to the data:
scalar: symmetric +/- values for all bars
shape(N,): symmetric +/- values for each bar
shape(2, N): Separate - and + values for each bar. First row contains the lower errors, the second row contains the upper errors.
None: No errorbar. (default)
See Different ways of specifying error bars for an example on the usage of xerr and yerr.
The line color of the errorbars.
rcParams["errorbar.capsize"] (default: 0.0)
The length of the error bar caps in points.
Dictionary of keyword arguments to be passed to the errorbar method. Values of ecolor or capsize defined here take precedence over the independent keyword arguments.
If True, set the x-axis to be log scale.
If given, all parameters also accept a string s, which is interpreted as data[s] if s is a key in data.
Rectangle properties
See also
bar
Plot a vertical bar plot.
Notes
Stacked bars can be achieved by passing individual left values per bar. See Discrete distribution as horizontal bar chart.
matplotlib.axes.Axes.barh#
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4