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=None, data=None)[源代码]¶ 绘制饼图。
制作数组的饼图 x . 每个楔子的分数面积由下式得出:
x/sum(x)
. 如果sum(x) < 1
,然后是 x 直接给出分数区域,数组将不会被规范化。生成的饼图将有一个大小为的空楔块1 - sum(x)
.默认情况下,从X轴开始逆时针绘制楔体。
参数: - x一维阵列状
楔形尺寸。
- explode类似数组,默认值:无
如果没有 None 是一个
len(x)
数组,指定要用其偏移每个楔块的半径分数。- labels列表,默认值:无
为每个楔子提供标签的字符串序列
- colors类似数组,默认值:无
饼图循环的一系列颜色。如果 None ,将使用当前活动周期中的颜色。
- autopctNone或str或callable,默认值:None
如果没有 None ,是一个字符串或函数,用于用其数值标记楔体。标签将放在楔形物内。如果是格式字符串,则标签将
fmt % pct
. 如果它是一个函数,则将调用它。- pctdistance浮动,默认值:0.6
每个饼图扇区的中心与由 自动验光 . 忽略如果 自动验光 是 None .
- shadowbool,默认值:False
在馅饼下面画一个阴影。
- 规格化:无或布尔,默认值:无
什么时候? True ,总是通过规范化x来制作一个完整的饼图,以便
sum(x) == 1
. 假 做一个部分派如果sum(x) <= 1
并提出ValueError
对于sum(x) > 1
.什么时候? None 默认为 True 如果
sum(x) >= 1
和 假 如果sum(x) < 1
.请注意,以前的默认值 None 现在已弃用,默认值将更改为 True 在下一个版本中。请通过
normalize=False
如果你想画一个部分饼图。- labeldistance浮动或无,默认值:1.1
绘制饼图标签的径向距离。如果设置为
None
,不绘制标签,但存储以在中使用legend()
- startangle浮动,默认值:0度
从x轴逆时针旋转饼图开始的角度。
- radius浮点,默认值:1
馅饼的半径。
- counterclockbool,默认值:True
指定分数方向,顺时针或逆时针。
- wedgepropsdict,默认值:无
传递给制作饼图的楔形对象的参数dict。例如,你可以通过
wedgeprops = {{'linewidth': 3}}
将楔形边框线的宽度设置为3。有关详细信息,请查看楔形对象的文档/参数。默认情况下clip_on=False
.- textpropsdict,默认值:无
要传递给文本对象的参数的dict。
- center(float,float),默认值:(0,0)
图表中心的坐标。
- framebool,默认值:False
如果为真,则用图表绘制轴框架。
- rotatelabelsbool,默认值:False
如果为真,则将每个标签旋转到相应切片的角度。
返回: - patches列表
一系列
matplotlib.patches.Wedge
实例- texts列表
标签列表
Text
实例。- autotexts列表
列表
Text
数字标签的实例。只有当参数 自动验光 不是 None .
笔记
如果图形和轴是方形的,或者轴方面是相等的,饼图可能看起来最好。此方法将轴的纵横比设置为“相等”。轴长宽比可通过
Axes.set_aspect
.注解
除了上述参数外,此函数还可以 data 关键字参数。如果这样的话 data 参数,下列参数也可以是字符串
s
,解释为data[s]
(除非引起例外): x , 爆炸 , 标签 , ** .作为传递的对象 data 必须支持项目访问 (
data[s]
)和会员资格测试 (s in data
)