matplotlib.pyplot.bar_label#

matplotlib.pyplot.bar_label(container, labels=None, *, fmt='%g', label_type='edge', padding=0, **kwargs)[源代码]#

为条形图添加标签。

为给定BarContainer中的条形添加标签。您可能需要调整坐标轴限制以适应标签。

参数:
containerBarContainer

包含所有条形图(以及可选的误差条)的容器,通常由barbarh返回。

labels类数组, 可选

要显示的标签文本列表。如果未给出,标签文本将是使用fmt格式化的数据值。

fmtstr 或 callable,默认值: '%g'

用于标签的无名 % 样式或 {} 样式格式字符串,或将值作为第一个参数调用的函数。当 fmt 是字符串且可以同时被两种格式解释时,% 样式优先于 {} 样式。

3.7 版本新增:支持 {} 样式格式字符串和可调用对象。

label_type{'edge', 'center'},默认值: 'edge'

标签类型。可能的值:

  • 'edge'(边缘):标签放置在条形段的末端,显示的值将是该末端的位置。

  • 'center'(中心):标签放置在条形段的中心,显示的值将是该段的长度。(适用于堆叠条形图,例如带标签的条形图

paddingfloat,默认值: 0

标签距条形末端的距离,以点为单位。

**kwargs

所有剩余的关键字参数都将传递给Axes.annotate。对齐参数(horizontalalignment / ha, verticalalignment / va)不受支持,因为标签会自动对齐到条形图。

返回:
列表中的Annotation

标签的Annotation实例列表。

备注

注意

这是pyplot 封装器,用于axes.Axes.bar_label

使用matplotlib.pyplot.bar_label的示例#

带标签的条形图

带标签的条形图

带标签的组合条形图

带标签的组合条形图

离散分布作为水平条形图

离散分布作为水平条形图