matplotlib.axes.Axes.pie#
- Axes.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
指定分数方向,顺时针或逆时针。
- wedgepropsdict, 默认值: None
传递给饼图每个
patches.Wedge
的参数字典。例如,wedgeprops = {'linewidth': 3}
将饼图扇形边框线的宽度设置为 3。默认情况下,clip_on=False
。当这些属性与其他关键字冲突时,传递给 wedgeprops 的属性优先。- textpropsdict, 默认值: 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.set_aspect
来控制。