matplotlib.axes.Axes.bar_label

Axes.bar_label(self, container, labels=None, *, fmt='%g', label_type='edge', padding=0, **kwargs) [source]

Label a bar plot.

Adds labels to bars in the given BarContainer. You may need to adjust the axis limits to fit the labels.

Parameters:
containerBarContainer

Container with all the bars and optionally errorbars, likely returned from bar or barh.

labelsarray-like, optional

A list of label texts, that should be displayed. If not given, the label texts will be the data values formatted with fmt.

fmtstr, default: '%g'

A format string for the label.

label_type{'edge', 'center'}, default: 'edge'

The label type. Possible values:

  • 'edge': label placed at the end-point of the bar segment, and the value displayed will be the position of that end-point.
  • 'center': label placed in the center of the bar segment, and the value displayed will be the length of that segment. (useful for stacked bars, i.e., Bar Label Demo)
paddingfloat, default: 0

Distance of label from the end of the bar, in points.

**kwargs

Any remaining keyword arguments are passed through to Axes.annotate.

Returns:
list of Text

A list of Text instances for the labels.

Examples using matplotlib.axes.Axes.bar_label

© 2012–2021 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.4.1/api/_as_gen/matplotlib.axes.Axes.bar_label.html