Python matplotlib Circle函数参数解释及用法

在 Matplotlib 中，Circle 函数用于绘制圆形，属于 matplotlib.patches 模块。以下是核心参数和使用方法：

关键参数说明

1. xy (必填)：圆心坐标，格式为 (x, y) 的元组

   • 示例：(0, 0) 表示原点为圆心

2. radius (必填)：圆的半径

   • 示例：radius=5 表示半径为5个单位

3. fill (可选)：是否填充颜色，默认为 True

   • 示例：fill=False 表示空心圆

4. color/facecolor (可选)：填充颜色

   • 示例：facecolor='red' 设置红色填充

5. edgecolor (可选)：边框颜色

   • 示例：edgecolor='blue' 设置蓝色边框

6. linewidth (可选)：边框宽度

   • 示例：linewidth=2 设置2像素宽边框

7. alpha (可选)：透明度（0-1）

   • 示例：alpha=0.5 设置半透明

完整使用示例

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

# 创建画布和坐标轴
fig, ax = plt.subplots(figsize=(6, 6))

# 创建圆形（圆心(2,3)，半径1.5，绿色填充，红色边框）
circle = Circle(
    xy=(2, 3), 
    radius=1.5,
    facecolor='green',
    edgecolor='red',
    linewidth=3,
    alpha=0.7
)

# 添加圆形到坐标轴
ax.add_patch(circle)

# 关键设置：确保显示为圆形（而非椭圆）
ax.set_aspect('equal')  # 等比例坐标轴

# 设置坐标范围并显示
plt.xlim(0, 5)
plt.ylim(0, 5)
plt.grid(True)
plt.title('Matplotlib Circle示例')
plt.show()

关键注意事项

1. 必须调用 ax.add_patch() 将圆形对象添加到坐标轴
2. 务必设置 ax.set_aspect('equal') 保证显示为完美圆形而非椭圆
3. 可通过 transform 参数切换坐标系（默认使用数据坐标系）
4. 多个圆形可叠加绘制，通过调整 xy 和 radius 定位

实际效果

该代码将生成一个：

• 中心在 (2,3)
• 半径1.5单位
• 半透明绿色填充
• 3像素宽红色边框
• 显示在5×5网格中的圆形