matplotlib.axes.Axes.pie_label#
- Axes.pie_label(container, /, labels, *, distance=0.6, textprops=None, rotate=False, alignment='auto')[source]#
为饼图添加标签。
于版本 3.11 新增。
为给定的
PieContainer中的扇区添加标签。- 参数:
- container
PieContainer 包含所有扇区的容器,通常由
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':标签远离饼图中心对齐,即饼图上半部分的标签底部对齐,饼图下半部分的标签顶部对齐。
- container
- 返回:
- list
标签
Text实例的列表。