### Navigation

- index
- modules |
- next |
- previous |
- home|
- examples|
- tutorials|
- pyplot|
- docs »
- The Matplotlib API »
- matplotlib.pyplot »

# matplotlib.pyplot.bar

`matplotlib.pyplot.``bar`(left, height, width=0.8, bottom=None, hold=None, data=None, **kwargs)

  Make a bar plot.

  Make a bar plot with rectangles bounded by:

  > `left`, `left` + `width`, `bottom`, `bottom` + `height`
  >   (left, right, bottom and top edges)

  Parameters: | left : sequence of scalars the x coordinates of the left sides of the bars height : scalar or sequence of scalars the height(s) of the bars width : scalar or array-like, optional the width(s) of the bars default: 0.8 bottom : scalar or array-like, optional the y coordinate(s) of the bars default: None color : scalar or array-like, optional the colors of the bar faces edgecolor : scalar or array-like, optional the colors of the bar edges linewidth : scalar or array-like, optional width of bar edge(s). If None, use default linewidth; If 0, don’t draw edges. default: None tick_label : string or array-like, optional the tick labels of the bars default: None xerr : scalar or array-like, optional if not None, will be used to generate errorbar(s) on the bar chart default: None yerr : scalar or array-like, optional if not None, will be used to generate errorbar(s) on the bar chart default: None ecolor : scalar or array-like, optional specifies the color of errorbar(s) default: None capsize : scalar, optional determines the length in points of the error bar caps default: None, which will take the value from the `errorbar.capsize` `rcParam`. error_kw : dict, optional dictionary of kwargs to be passed to errorbar method. ecolor and capsize may be specified here rather than as independent kwargs. align : {‘center’, ‘edge’}, optional, default: ‘center’ If ‘edge’, aligns bars by their left edges (for vertical bars) and by their bottom edges (for horizontal bars). If ‘center’, interpret the `left` argument as the coordinates of the centers of the bars. To align on the align bars on the right edge pass a negative `width`. orientation : {‘vertical’, ‘horizontal’}, optional The orientation of the bars. log : boolean, optional If true, sets the axis to be log scale. default: False
  Returns: | bars : matplotlib.container.BarContainer Container with all of the bars + errorbars

  See also

  `barh`
    Plot a horizontal bar plot.
  ``
    In addition to the above described arguments, this function can take a data keyword argument. If such a data argument is given, the following arguments are replaced by data[<arg>]: * All arguments with the following names: ‘bottom’, ‘color’, ‘ecolor’, ‘edgecolor’, ‘height’, ‘left’, ‘linewidth’, ‘tick_label’, ‘width’, ‘xerr’, ‘yerr’.

  Notes

  The optional arguments `color`, `edgecolor`, `linewidth`, `xerr`, and `yerr` can be either scalars or sequences of length equal to the number of bars. This enables you to use bar as the basis for stacked bar charts, or candlestick plots. Detail: `xerr` and `yerr` are passed directly to `errorbar()`, so they can also have shape 2xN for independent specification of lower and upper errors.

  Other optional kwargs:

  > Property | Description
  > --- | ---
  > `agg_filter` | unknown
  > `alpha` | float or None
  > `animated` | [True | False]
  > `antialiased` or aa | [True | False] or None for default
  > `axes` | an `Axes` instance
  > `capstyle` | [‘butt’ | ‘round’ | ‘projecting’]
  > `clip_box` | a `matplotlib.transforms.Bbox` instance
  > `clip_on` | [True | False]
  > `clip_path` | [ (`Path`, `Transform`) | `Patch` | None ]
  > `color` | matplotlib color spec
  > `contains` | a callable function
  > `edgecolor` or ec | mpl color spec, None, ‘none’, or ‘auto’
  > `facecolor` or fc | mpl color spec, or None for default, or ‘none’ for no color
  > `figure` | a `matplotlib.figure.Figure` instance
  > `fill` | [True | False]
  > `gid` | an id string
  > `hatch` | [‘/’ | ‘' | ‘|’ | ‘-‘ | ‘+’ | ‘x’ | ‘o’ | ‘O’ | ‘.’ | ‘*’]
  > `joinstyle` | [‘miter’ | ‘round’ | ‘bevel’]
  > `label` | string or anything printable with ‘%s’ conversion.
  > `linestyle` or ls | [‘solid’ | ‘dashed’, ‘dashdot’, ‘dotted’ | (offset, on-off-dash-seq) | `'-'` | `'--'` | `'-.'` | `':'` | `'None'` | `' '` | `''`]
  > `linewidth` or lw | float or None for default
  > `path_effects` | unknown
  > `picker` | [None|float|boolean|callable]
  > `rasterized` | [True | False | None]
  > `sketch_params` | unknown
  > `snap` | unknown
  > `transform` | `Transform` instance
  > `url` | a url string
  > `visible` | [True | False]
  > `zorder` | any number

## Examples using `matplotlib.pyplot.bar`

Stacked Bar Graph

Custom Ticker1

Log Bar

System Monitor

Table Demo

Pyplot tutorial