📝 摘要
这篇教程面向需要批量生成CF风格曼陀罗图案的设计师与Python开发者，手把手讲解从环境搭建到成品输出的完整流程。核心看点有三：一是通过config.yaml集中管理对称轴数量、层数、随机种子等曼陀罗参数，保证每次生成结果可复现；二是利用径向扰动与viridis渐变映射，让对称点集呈现自然流动感；三是加入径向模糊、镜像混合与蓝紫调色映射等CF专属滤镜，强化标志性视觉风格。跟着做即可输出300dpi高清对称图案，告别手动绘制效率低、精度差的困扰。
学完本教程，你将能独立配置并运行CF曼陀罗生成系统，输出符合参数要求的对称图案，解决手动绘制效率低、对称精度差的问题。
第一步：环境准备与依赖安装
1. 确认系统已安装Python 3.8及以上版本，在终端执行 `python --version` 验证。
2. 安装核心库：`pip install numpy matplotlib pillow`。若需GPU加速，额外安装 `pip install cupy-cuda11x`（根据CUDA版本调整）。
3. 创建项目目录 `cf_mandala`，并在其中新建 `config.yaml` 文件，用于存放曼陀罗参数。
第二步：定义曼陀罗基本参数
在 `config.yaml` 中写入以下字段：
- `center`: [0, 0] # 中心坐标
- `radius`: 500 # 最大半径（像素）
- `symmetry`: 12 # 对称轴数量（CF模式建议8-24）
- `layers`: 5 # 同心层数
- `color_mode`: "cf_gradient" # 使用CF渐变模式
- `seed`: 42 # 随机种子，保证可复现
第三步：生成基础对称点集
1. 编写 `generate_points.py`，导入numpy。
2. 对于每一层 `i`（从0到layers-1），计算当前层半径 `r = radius * (i+1)/layers`。
3. 在每个对称轴角度 `theta = 2*pi*k/symmetry`（k从0到symmetry-1）上，生成点 `(r*cos(theta), r*sin(theta))`。
4. 为增加CF曼陀罗的流动感，对每个点添加径向扰动：`r_perturbed = r * (1 + 0.1 * sin(3*theta + i))`。
5. 将所有点存入列表 `points`，并转换为numpy数组。
第四步：绘制连接线与填充区域
1. 使用matplotlib创建画布：`fig, ax = plt.subplots(figsize=(10,10))`，设置 `ax.set_aspect('equal')`。
2. 对于每一层，按顺序连接相邻对称轴上的点，形成闭合多边形。使用 `ax.plot` 绘制线条，线宽设为 `1.5`。
3. 填充多边形内部：调用 `ax.fill`，颜色从CF渐变映射中获取。渐变映射规则：`color = plt.cm.viridis((i + 1) / layers)`。
4. 重复直到所有层绘制完毕。
第五步：应用CF曼陀罗特有滤镜
1. 在 `config.yaml` 中启用 `cf_filter: true`。
2. 实现径向模糊：对每个像素，沿径向方向取5个采样点，计算加权平均。可使用 `scipy.ndimage.map_coordinates` 加速。
3. 添加镜像对称增强：对图像做左右翻转，再与原图按 `0.7:0.3` 比例混合。
4. 最后进行色调映射：将RGB通道分别乘以 `[1.1, 0.9, 1.2]`，增强CF标志性的蓝紫调。
第六步：输出与验证
1. 保存图像：`plt.savefig('cf_mandala_output.png', dpi=300, bbox_inches='tight')`。
2. 运行 `python generate_points.py`，检查输出文件是否存在。
3. 打开图像，确认对称轴数量与 `config.yaml` 一致。可用 `PIL` 读取像素，验证中心区域亮度是否呈辐射状递减。
常见坑提醒：
- 忘记设置 `ax.set_aspect('equal')` 会导致曼陀罗被拉伸变形。
- 对称轴数量设为奇数时，CF滤镜的镜像混合会产生错位，建议始终用偶数。
- 径向模糊的采样点过多会显著拖慢速度，5个点足够；若卡顿，改用 `numexpr` 优化。
- 随机种子不固定时，每次生成的扰动不同，不利于调试，务必在配置中写死 `seed`。
- 输出DPI低于200时，细线条会出现锯齿，建议至少300。
