matplotlib.pyplot.barh

matplotlib.pyplot。barh ( y , width , height = 0.8 , left = None , * , align = 'center' , data = None , ** kwargs )

制作水平条形图。

条形图以给定的对齐方式定位在y处。它们的尺寸由width和height给出。水平基线为左（默认为 0）。

许多参数可以采用单个值应用于所有条形或一系列值，每个条形一个值。

参数：

y浮点数或类似数组

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

宽度浮点数或类似数组

条的宽度。

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

酒吧的高度。

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

条形左侧的 x 坐标。

对齐{'center', 'edge'}，默认值：'center'

基数与y坐标的对齐*：

• 'center'：将条形置于y位置的中心。

• 'edge'：将条形的底部边缘与y 位置对齐。

要对齐顶部边缘上的条形，请传递一个负高度和 align='edge'.

返回：

BarContainer

包含所有条形图和可选误差线的容器。

其他参数：

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

条形面的颜色。

edgecolor颜色或颜色列表，可选

条形边缘的颜色。

linewidth float 或类似数组，可选

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

tick_label str 或 str 列表，可选

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

标签str 或 str 列表，可选

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

xerr, yerr float 或 shape(N,) 或 shape(2, N) 的类似数组，可选

如果不是None，则将水平/垂直误差条添加到条形提示。这些值是相对于数据的 +/- 大小：

• 标量：所有条形的对称 +/- 值

• shape(N,)：每个条的对称 +/- 值

• shape(2, N)：为每个条形分隔 - 和 + 值。第一行包含较低的错误，第二行包含较高的错误。

• 无：没有错误栏。（默认）

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

ecolor颜色或颜色列表，默认值：'black'

误差线的线条颜色。

翻船浮动，默认值：（rcParams["errorbar.capsize"]默认值0.0：）

误差线上限的长度（以磅为单位）。

error_kw字典，可选

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

日志布尔值，默认值：False

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

数据可索引对象，可选

如果给定，所有参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）。

**kwargsRectangle属性

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
angle	未知
animated	布尔
antialiased或aa	布尔或无
bounds	（左、下、宽、高）
capstyle	CapStyle或 {'butt', 'projecting', 'round'}
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
color	颜色
edgecolor或 ec	颜色或无
facecolor或 fc	颜色或无
figure	Figure
fill	布尔
gid	字符串
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
height	未知
in_layout	布尔
joinstyle	JoinStyle或 {'miter', 'round', 'bevel'}
label	目的
linestyle或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth或 lw	浮动或无
mouseover	布尔
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
width	未知
x	未知
xy	（浮动，浮动）
y	未知
zorder	漂浮

也可以看看

bar

绘制垂直条形图。

笔记

堆叠条可以通过每个条传递单独的左值来实现。请参阅 作为水平条形图的离散分布。