Python中的 Matplotlib.patches.Circle 类

Matplotlib是Python中一个常用的绘图库，提供了绘制2D图表（如线图、散点图、柱状图、等高线图、3D图表等）和一些基本的数据可视化工具。Matplotlib.patches.Circle是matplotlib.patches模块中的一个类，用于绘制圆形(patch)对象。

Circle类简介

matplotlib.patches.Circle类是绘制圆形的patch对象，其构造方法如下：

Circle(xy, radius, **kwargs)

其中，参数xy是圆心坐标，radius是圆形半径，其余的关键字参数kwargs和其他patch类型一样，可以设置如下属性：

• alpha: float类型，透明度，默认1.0
• antialiased or aa: bool类型，是否开启抗锯齿，默认False
• edgecolor or ec: matplotlib颜色参数，边缘颜色，默认'none'
• facecolor or fc: matplotlib颜色参数，填充颜色，默认None，即不填充
• figure: matplotlib.figure.Figure实例，表示绘制该circle对象的图像，如果未提供，则使用当前图像
• label: str类型，标签，默认None
• linestyle or ls: str类型，边框线形，默认'-'
• linewidth or lw: float类型，边界线宽度，默认1.0
• transform: matplotlib.transforms.Transform实例，表示(circle坐标系 -> 绘图坐标系)的几何变换，默认None
• visible: bool类型，表示circle是否可见，默认True
• zorder: float类型，zorder值，决定绘制顺序，默认1.0

Circle类示例

下面是一个简单的使用例子：

import matplotlib.pyplot as plt
from matplotlib.patches import Circle

fig, ax = plt.subplots()
circ = Circle((0.5, 0.5), 0.2, facecolor='red', edgecolor='blue', linewidth=2.0, alpha=0.5)
ax.add_patch(circ)
plt.show()

运行后将得到如下图形：

在该例子中，我们创建了一个matplotlib.pyplot.Figure实例和一个matplotlib.pyplot.Axes实例，并使用add_patch方法将Circle类的实例对象circ添加到Axes实例上。圆心坐标为(0.5, 0.5)，半径为0.2，填充颜色为红色（'red'），边框颜色为蓝色（'blue'），边框线宽度为2.0，透明度为0.5。最后，通过plt.show()方法显示图形。

结语

matplotlib.patches.Circle类是绘制圆形的patch对象，通过Circle类的构造方法可以轻松地创建圆形。本文介绍了Circle类的使用方法和示例，并列出了关键字参数的各种属性。如果读者需要创建其他形状的patch对象，可以去了解matplotlib.patches模块中其他类型的patch对象。