matplotlib.axes.Axes.barh#

Axes.barh(y, width, height=0.8, left=None, *, align='center', data=None, **kwargs)[源代码][源代码]#

制作一个水平条形图。

条形图位于 y 位置，并按照给定的 align 对齐。它们的尺寸由 width 和 height 决定。水平基线为 *left*（默认值为 0）。

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

参数:

y浮点数或类似数组的对象

条形的y坐标。另见 align 以了解条形与坐标的对齐方式。

宽度浮点数或类似数组的对象

条形的宽度。

请注意，如果 left 有单位（例如 datetime），width 应该使用与 left 值的差值单位（例如 timedelta）。

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

柱状图的高度。

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

左浮点数或类数组，默认值：0

条形图左侧的 x 坐标。

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

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

基线与 y 坐标的对齐*:

'center': 将条形图中心对齐到 y 位置。
'edge': 将条形的底部边缘与 y 位置对齐。

要将条形图对齐到顶部边缘，传递一个负的 height 并设置 align='edge'。

返回:

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

其他参数:

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

条形面的颜色。

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

条形边缘的颜色。

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

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

tick_labelstr 或 str 列表，可选

柱状图的刻度标签。默认值：None（使用默认的数字标签。）

标签str 或 str 列表，可选

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

数据可索引对象，可选

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

**kwargs : Rectangle 属性矩形属性

属性	描述
`agg_filter`	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
`alpha`	标量或无
`angle`	未知
`animated`	布尔值
`抗锯齿` 或 aa	布尔值或无
`bounds`	(左, 底, 宽, 高)
`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`
`fill`	布尔值
`gid`	str
`hatch`	{'/', '', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`高度`	未知
`in_layout`	布尔值
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`标签`	对象
`线条样式` 或 ls	{'-', '--', '-.', ':', '', (偏移, 开-关-序列), ...}
`线宽` 或 lw	浮点数或无
`鼠标悬停`	布尔值
`路径效果`	`AbstractPathEffect` 的列表
`picker`	None 或 bool 或 float 或 callable
`栅格化`	布尔值
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	布尔值或无
`transform`	`Transform`
`url`	str
`可见`	布尔值
`宽度`	未知
`x`	未知
`xy`	(浮点数, 浮点数)
`y`	未知
`zorder`	浮动