matplotlib.pyplot.bar_label#

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

标记条形图。

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

参数:
容器 : BarContainerBarContainer

包含所有条形图以及可选误差线的容器,可能由 barbarh 返回。

标签类似数组,可选

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

fmtstr 或 callable, 默认: '%g'

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

Added in version 3.7: 支持 {} 风格的格式字符串和可调用对象。

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

标签类型。可能的值:

  • 'edge': 标签放置在条形段的端点,显示的值将是该端点的位置。

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

填充float, 默认值: 0

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

**kwargs

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

返回:
Annotation 列表

标签的 Annotation 实例列表。

注释

备注

这是 axes.Axes.bar_labelpyplot 封装

使用 matplotlib.pyplot.bar_label 的示例#

带有标签的条形图

Bar chart with labels

带标签的分组条形图

Grouped bar chart with labels

离散分布作为水平条形图

Discrete distribution as horizontal bar chart