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轴开始逆时针绘制。
- 参数:
- x1D 数组类
楔形尺寸。
- 爆炸类似数组，默认: None
如果不是 None，这是一个
len(x)数组，它指定每个楔形偏移其半径的分数。- 标签列表，默认值：无
提供每个楔形标签的字符串序列
- 颜色 : color 或 color 列表, 默认: None颜色或颜色列表，默认: None
饼图将循环通过的一系列颜色。如果为 None ，将使用当前活动循环中的颜色。
- hatchstr 或 list, 默认: None
应用于所有饼图楔形的填充图案或图表将循环的图案序列。有关有效图案的列表，请参阅 Hatch 样式参考。
Added in version 3.7.
- autopctNone 或 str 或 callable，默认: None
如果 autopct 不是 None，它是一个用于在楔形上标注数值的字符串或函数。标签将被放置在楔形内部。如果 autopct 是一个格式字符串，标签将是
fmt % pct。如果 autopct 是一个函数，那么它将被调用。- pctdistancefloat, 默认值: 0.6
沿着半径的相对距离，在此处绘制由 autopct 生成的文本。要使文本绘制在饼图外部，请设置 pctdistance > 1。如果 autopct 为
None，则忽略此参数。- labeldistance浮点数或无，默认值：1.1
标签绘制的径向相对距离。要在饼图内部绘制标签，请设置 labeldistance < 1。如果设置为
None，则不绘制标签，但仍存储以供在legend中使用。- 阴影布尔值或字典，默认值：False
如果是布尔值，是否在饼图下方绘制阴影。如果是字典，则通过字典中的属性传递给
Shadow来绘制阴影。Added in version 3.8: shadow 可以是一个字典。
- startangle浮动，默认：0度
饼图起始点相对于x轴逆时针旋转的角度。
- 半径float, 默认值: 1
饼图的半径。
- counterclockbool, 默认: True
指定分数方向，顺时针或逆时针。
- wedgeprops字典, 默认值: None
传递给饼图中每个
patches.Wedge的参数字典。例如，wedgeprops = {'linewidth': 3}将楔形边框线的宽度设置为 3。默认情况下，clip_on=False。当这些属性与其他关键字冲突时，传递给 wedgeprops 的属性优先。- textprops字典, 默认值: None
传递给文本对象的参数字典。
- 中心(float, float), 默认值: (0, 0)
图表中心的坐标。
- 框架bool, 默认值: False
如果为真，则在图表中绘制轴框。
- rotatelabelsbool, 默认值: False
如果为真，将每个标签旋转到相应切片的角度。
- 标准化bool, 默认: True
当 True 时，总是通过规范化 x 来制作一个完整的饼图，使得
sum(x) == 1。False 则会在sum(x) <= 1时制作一个部分饼图，并在sum(x) > 1时引发ValueError。- 数据可索引对象，可选
如果给出，以下参数还接受一个字符串
s，如果s是data中的一个键，则解释为data[s]：x, explode, labels, colors
- 返回:
- 补丁列表
一系列
matplotlib.patches.Wedge实例- 文本列表
标签
Text实例的列表。- 自动文本列表
数字标签的
Text实例列表。仅当参数 autopct 不为 None 时才会返回。
注释
备注
这是
axes.Axes.pie的 pyplot 包装器。如果图形和坐标轴是正方形，或者坐标轴的纵横比相等，饼图看起来可能会最好。此方法将坐标轴的纵横比设置为“相等”。坐标轴的纵横比可以通过
Axes.set_aspect来控制。
