matplotlib.pyplot.barh#

matplotlib.pyplot.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	布尔值或无
`边界`	（左，底，宽，高）
`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`	float