matplotlib.pyplot.pie#
- matplotlib.pyplot.pie(x, *, explode=None, labels=None, colors=None, autopct=None, pctdistance=0.6, shadow=False, labeldistance=1.1, startangle=0, radius=1, counterclock=True, wedgeprops=None, textprops=None, center=(0, 0), frame=False, rotatelabels=False, normalize=True, hatch=None, data=None)[来源]#
绘制饼图。
绘制数组 x 的饼图。每个扇形区域的面积比例由
x/sum(x)给出。默认情况下，扇形区域按逆时针方向绘制，从X轴开始。
- 参数:
- x一维数组类型
扇形区域的大小。
- explode数组类型, 默认值: None
如果不是 None，则是一个
len(x)数组，用于指定每个扇形区域偏离半径的比例。- labels列表, 默认值: None
提供每个扇形区域标签的字符串序列
- colors颜色 或 颜色 列表, 默认值: None
饼图将循环使用的颜色序列。如果为 None，将使用当前活动循环中的颜色。
- hatch字符串 或 列表, 默认值: None
应用于所有饼图扇形区域的填充模式，或图表将循环使用的模式序列。有关有效模式的列表，请参阅 填充样式参考。
版本 3.7 新增。
- autopctNone 或 字符串 或 可调用对象, 默认值: None
如果不是 None，autopct 是一个字符串或函数，用于使用其数值标记扇形区域。标签将放置在扇形区域内部。如果 autopct 是一个格式字符串，标签将是
fmt % pct。如果 autopct 是一个函数，则会调用它。- pctdistance浮点数, 默认值: 0.6
绘制 autopct 生成的文本的相对半径距离。要将文本绘制在饼图外部，请将 pctdistance 设置为 > 1。如果 autopct 为
None，则忽略此参数。- labeldistance浮点数 或 None, 默认值: 1.1
绘制标签的相对半径距离。要将标签绘制在饼图内部，请将 labeldistance 设置为 < 1。如果设置为
None，则不绘制标签，但仍会存储以供在legend中使用。- shadow布尔值 或 字典, 默认值: False
如果是布尔值，则表示是否在饼图下方绘制阴影。如果是字典，则绘制阴影并将字典中的属性传递给
Shadow。3.8 版本新增：shadow 可以是字典。
- startangle浮点数, 默认值: 0 度
饼图起始部分相对于X轴逆时针旋转的角度。
- radius浮点数，默认值：1
饼图的半径。
- counterclock布尔值, 默认值: True
指定扇形方向，顺时针或逆时针。
- wedgeprops字典, 默认值: None
传递给每个饼图
patches.Wedge扇形区域的参数字典。例如，wedgeprops = {'linewidth': 3}将扇形区域边界线的宽度设置为3。默认情况下，clip_on=False。当这些属性与其他关键字冲突时，传递给 wedgeprops 的属性优先。- textprops字典, 默认值: None
传递给文本对象的参数字典。
- center(浮点数, 浮点数)，默认值：(0, 0)
图表中心的坐标。
- frame布尔值, 默认值: False
如果为 True，则绘制带图表的坐标轴框架。
- rotatelabels布尔值, 默认值: False
如果为 True，则将每个标签旋转到相应切片的角度。
- normalize布尔值, 默认值: True
当为 True 时，通过归一化 x 使
sum(x) == 1，从而始终绘制一个完整的饼图。如果sum(x) <= 1，则 False 绘制一个部分饼图，如果sum(x) > 1则引发ValueError。- data可索引对象，可选
如果给定，以下参数也接受字符串
s，如果s是data中的键，则将其解释为data[s]x, explode, labels, colors
- 返回:
- patches列表
一系列
matplotlib.patches.Wedge实例- texts列表
标签
Text实例列表。- autotexts列表
一组
Text数值标签实例。仅当参数 autopct 不为 None 时才返回此值。
备注
注意
这是 pyplot 封装器 的
axes.Axes.pie。如果图形和坐标轴是方形的，或者坐标轴的纵横比相等，饼图效果可能会最好。此方法将坐标轴的纵横比设置为“相等”。坐标轴的纵横比可以通过
Axes.set_aspect控制。
