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
传递给
Text对象的参数字典。- center(浮点数, 浮点数)，默认值：(0, 0)
图表中心坐标。
- frame布尔值，默认值：False
若为 True，则随图表绘制坐标轴框架。
- rotatelabels布尔值，默认值：False
若为 True，则将每个标签旋转至对应扇形的角度。
- normalize布尔值，默认值：True
若为 True，通过归一化 x 使得
sum(x) == 1，从而始终绘制一个完整的饼图。若为 False，当sum(x) <= 1时绘制部分饼图，若sum(x) > 1则引发ValueError。- data可索引对象，可选
如果给定，以下参数也接受字符串
s，如果s是data中的键，则将其解释为data[s]。x, explode, labels, colors
- 返回:
PieContainer包含所有扇形补丁及任何相关文本对象的容器。
版本 3.11 变更: 之前扇形和文本以元组形式返回。
备注
注意
这是 pyplot 包装器，对应
axes.Axes.pie。当图形和坐标轴为正方形，或坐标轴纵横比相等时，饼图呈现效果最佳。此方法将坐标轴的纵横比设置为 "equal"。坐标轴的纵横比可以通过
Axes.set_aspect进行控制。
