matplotlib.pyplot.bar_label#
- matplotlib.pyplot.bar_label(container, labels=None, *, fmt='%g', label_type='edge', padding=0, **kwargs)[源代码][源代码]#
标记条形图。
在给定的
BarContainer
中添加标签。您可能需要调整轴的限制以适应标签。- 参数:
- 容器 :
BarContainer
BarContainer
- 标签类似数组,可选
应显示的标签文本列表。如果未提供,标签文本将是使用 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_label
的 pyplot 封装。