matplotlib 3.5.1

NotesOther ParametersParametersReturnsBackRef
barh(y, width, height=0.8, left=None, *, align='center', **kwargs)

The bars are positioned at y with the given align\ment. 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.

Notes

Stacked bars can be achieved by passing individual left values per bar. See /gallery/lines_bars_and_markers/horizontal_barchart_distribution .

Other Parameters

color : color or list of color, optional

The colors of the bar faces.

edgecolor : color or list of color, optional

The colors of the bar edges.

linewidth : float or array-like, optional

Width of the bar edge(s). If 0, don't draw edges.

tick_label : str or list of str, optional

The tick labels of the bars. Default: None (Use default numeric labels.)

xerr, yerr : float or array-like of shape(N,) or shape(2, N), optional

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 /gallery/statistics/errorbar_features for an example on the usage of xerr and yerr .

ecolor : color or list of color, default: 'black'

The line color of the errorbars.

capsize : float, default: :rc:`errorbar.capsize`

The length of the error bar caps in points.

error_kw : dict, optional

Dictionary of kwargs to be passed to the ~.Axes.errorbar method. Values of ecolor or capsize defined here take precedence over the independent kwargs.

log : bool, default: False

If True , set the x-axis to be log scale.

**kwargs : `.Rectangle` properties
Properties: :

agg_filter: a filter function, which takes a (m, n, 3) float array and a dpi value, and returns a (m, n, 3) array alpha: scalar or None angle: unknown animated: bool antialiased or aa: bool or None bounds: (left, bottom, width, height) capstyle: .CapStyle or {'butt', 'projecting', 'round'} clip_box: .Bbox clip_on: bool clip_path: Patch or (Path, Transform) or None color: color edgecolor or ec: color or None facecolor or fc: color or None figure: .Figure fill: bool gid: str hatch: {'/', '\\', '|', '-', '+', 'x', 'o', 'O', '.', '*'} height: unknown in_layout: bool joinstyle: .JoinStyle or {'miter', 'round', 'bevel'} label: object linestyle or ls: {'-', '--', '-.', ':', '', (offset, on-off-seq), ...} linewidth or lw: float or None path_effects: .AbstractPathEffect picker: None or bool or float or callable rasterized: bool sketch_params: (scale: float, length: float, randomness: float) snap: bool or None transform: .Transform url: str visible: bool width: unknown x: unknown xy: (float, float) y: unknown zorder: float

Parameters

y : float or array-like

The y coordinates of the bars. See also align for the alignment of the bars to the coordinates.

width : float or array-like

The width(s) of the bars.

height : float or array-like, default: 0.8

The heights of the bars.

left : float or array-like, default: 0

The x coordinates of the left sides of the bars.

align : {'center', 'edge'}, default: 'center'

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' .

Returns

`.BarContainer`

Container with all the bars and optionally errorbars.

Make a horizontal bar plot.

See Also

bar

Plot a vertical bar plot.

Examples

See :

Back References

The following pages refer to to this document either explicitly or contain code examples using this.

matplotlib.pyplot.bar matplotlib.pyplot.plotting

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


File: /matplotlib/pyplot.py#2401
type: <class 'function'>
Commit: