matplotlib.pyplot.pie_label#

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

为饼图添加标签。

于版本 3.11 新增。

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

参数:
containerPieContainer

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

labels字符串或字符串列表

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

wedge_labels="{absval:d} ({frac:.0%})"
distance浮点数,默认值:0.6

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

textprops字典,默认值:None

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

rotate布尔值,默认值:False

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

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

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

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

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

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

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

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

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

返回:
list

标签 Text 实例列表。

备注

注意

这是 axes.Axes.pie_labelpyplot 包装器

使用 matplotlib.pyplot.pie_label 的示例#

带标签的饼图和甜甜圈图

带标签的饼图和甜甜圈图

饼图标注

饼图标注