https://matplotlib.org/api/pyplot_api.html
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
height : sequence of scalars
width : scalar or array-like, optional
bottom : scalar or array-like, optional
color : scalar or array-like, optional
edgecolor : scalar or array-like, optional
linewidth : scalar or array-like, optional
tick_label : string or array-like, optional
xerr : scalar or array-like, optional
yerr : scalar or array-like, optional
ecolor : scalar or array-like, optional
capsize : scalar, optional
error_kw : dict, optional
align : {‘center’, ‘edge’}, optional
orientation : {‘vertical’, ‘horizontal’}, optional
log : boolean, optional
|
---|---|
Returns: | bars : matplotlib.container.BarContainer
|
See also
- Plot a horizontal bar plot.
barh
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
instancecapstyle
[‘butt’ | ‘round’ | ‘projecting’] clip_box
a matplotlib.transforms.Bbox
instanceclip_on
[True | False] clip_path
[ ( Path
,Transform
) |Patch
| None ]color
matplotlib color spec contains
a callable function edgecolor
or ecmpl color spec, None, ‘none’, or ‘auto’ facecolor
or fcmpl color spec, or None for default, or ‘none’ for no color figure
a matplotlib.figure.Figure
instancefill
[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 lwfloat or None for default path_effects
unknown picker
[None|float|boolean|callable] rasterized
[True | False | None] sketch_params
unknown snap
unknown transform
Transform
instanceurl
a url string visible
[True | False] zorder
any number
Examples
Example: A stacked bar chart.
(Source code, png, pdf)
![../_images/bar_stacked2.png](https://i-blog.csdnimg.cn/blog_migrate/491fde55ce2840659084fd1507725fd8.png)
Note
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’.