matplotlib.axes.Axes.pie_label#

Axes.pie_label(container, /, labels, *, distance=0.6, textprops=None, rotate=False, alignment='auto')[source]#

为饼图添加标签。

于版本 3.11 新增。

为给定的 PieContainer 中的扇区添加标签。

参数:
containerPieContainer

包含所有扇区的容器,通常由 pie 返回。

labelsstr 或 str 列表

为每个扇区提供标签的字符串序列,或者带有 absval 和/或 frac 占位符的格式字符串。例如,用数值和方括号内的百分比标记每个扇区

wedge_labels="{absval:d} ({frac:.0%})"
distancefloat, 默认值: 0.6

标签的径向位置,相对于饼图半径。值 > 1 表示在扇区外,值 < 1 表示在扇区内。

textprops字典,默认值:None

传递给 Text 对象的参数字典。

rotatebool, 默认值: False

若为 True,则将每个标签旋转至对应扇形的角度。

alignment{'center', 'outer', 'auto'}, 默认值: 'auto'

控制文本对象相对于其名义位置的水平对齐方式。

  • 'center':标签在其点上居中。

  • 'outer':标签远离饼图中心对齐,即饼图左侧的标签右对齐,饼图右侧的标签左对齐。

  • 'auto':如果 distance > 1,则转换为 'outer'(从而使标签不会覆盖扇区);如果 distance < 1,则转换为 'center'。

如果 rotate 为 True,垂直对齐也会受到类似的影响。

  • 'center':标签在其点上居中。

  • 'outer':标签远离饼图中心对齐,即饼图上半部分的标签底部对齐,饼图下半部分的标签顶部对齐。

返回:
list

标签 Text 实例的列表。

使用 matplotlib.axes.Axes.pie_label 的示例#

带标签的饼图和甜甜圈图

带标签的饼图和甜甜圈图

饼图标注

饼图标注