matplotlib.axes.Axes.bar#

Axes.bar(x, height, width=0.8, bottom=None, *, align='center', data=None, **kwargs)[源代码][源代码]#

制作一个条形图。

条形图位于 x 位置，并根据给定的 align 对齐方式排列。其尺寸由 height 和 width 确定。垂直基线为 *bottom*（默认值为 0）。

许多参数可以接受一个适用于所有条形的单一值，或是一个序列值，每个条形对应一个值。

参数:

x浮点数或类数组

条形的 x 坐标。另请参阅 align 以了解条形与坐标的对齐方式。

高度浮点数或类数组

条形的高度。

请注意，如果 bottom 有单位（例如 datetime），height 应该以与 bottom 值的差值为单位的值（例如 timedelta）。

宽度浮点数或类似数组的对象，默认值：0.8

柱形的宽度。

请注意，如果 x 具有单位（例如 datetime），那么 width 应该是在 x 值周围的差异单位（例如 timedelta）。

底部浮点数或类似数组的对象，默认值：0

条形图底部边的 y 坐标。

请注意，如果 bottom 有单位，那么 y 轴将获得适合该单位的定位器和格式化器（例如日期或分类）。

对齐{'center', 'edge'}, 默认: 'center'

条形图与 x 坐标的对齐方式：

'center': 将基线居中于 x 位置。
'edge': 将条形的左边缘与 x 位置对齐。

要使条形图与右边缘对齐，请传递一个负的 width 并设置 align='edge'。

返回:

BarContainer: 包含所有条形图，并可选择包含误差条的容器。

其他参数:

颜色 : color 或 color 列表，可选颜色或颜色列表，可选

条形面的颜色。

edgecolor : color 或 color 列表, 可选颜色或颜色列表，可选

条形边缘的颜色。

行宽浮点数或类似数组的对象，可选

条形边缘的宽度。如果为0，则不绘制边缘。

tick_labelstr 或 str 列表，可选

条形的刻度标签。默认值：None（使用默认的数字标签。）

标签str 或 str 列表，可选

单个标签附加到生成的 BarContainer 上，作为整个数据集的标签。如果提供了一个列表，它必须与 x 的长度相同，并标记各个条形。重复的标签不会去重，并且会导致重复的标签条目，因此最好在条形也具有不同样式时使用（例如，通过将列表传递给 color。）

xerr, yerr浮点数或形状为(N,)或形状为(2, N)的可选数组

如果不是 None，则在条形图的末端添加水平/垂直误差线。这些值是相对于数据的正负大小：

标量：所有条形的对称 +/- 值
shape(N,): 每个条形的对称 +/- 值
shape(2, N): 为每个条形图分别提供 - 和 + 值。第一行包含较低的误差，第二行包含较高的误差。
None: 无误差条。（默认）

有关 xerr 和 yerr 的使用示例，请参见指定误差线的不同方式。

ecolor : color 或 color 列表, 默认: '黑色'颜色或颜色列表，默认值：'黑色'

误差线的线条颜色。

capsize : float, 默认值: rcParams["errorbar.capsize"] (default: 0.0)浮点数，默认值：

误差条帽的长度，单位为点。

error_kwdict, 可选

要传递给 errorbar 方法的关键字参数字典。此处定义的 ecolor 或 capsize 值优先于独立的关键字参数。

日志bool, 默认: False

如果 True，将 y 轴设置为对数刻度。

数据可索引对象，可选

如果给出，所有参数也接受一个字符串 s，如果 s 是 data 中的一个键，则它被解释为 data[s]。

**kwargs : Rectangle 属性矩形属性

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 的浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
`alpha`	标量或无
`angle`	未知
`animated`	布尔
`抗锯齿` 或 aa	布尔值或无
`边界`	(左, 底, 宽, 高)
`capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`clip_box`	`BboxBase` 或 None
`clip_on`	布尔
`clip_path`	补丁或（路径，变换）或无
`颜色`	color
`edgecolor` 或 ec	color or None
`facecolor` 或 fc	color or None
`figure`	`Figure` 或 `SubFigure`
`填充`	布尔
`gid`	str
`hatch`	{'/', '', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`高度`	未知
`in_layout`	布尔
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`标签`	对象
`linestyle` 或 ls	{'-', '--', '-.', ':', '', (偏移, 开-关-序列), ...}
`linewidth` 或 lw	浮点数或无
`鼠标悬停`	布尔
`path_effects`	`AbstractPathEffect` 的列表
`picker`	None 或 bool 或 float 或 callable
`光栅化`	布尔
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	布尔值或无
`transform`	`Transform`
`url`	str
`可见`	布尔
`宽度`	未知
`x`	未知
`xy`	(浮点数, 浮点数)
`y`	未知
`zorder`	浮动