使用 POV-Ray 进行科学可视化
此技能打包了一组 POV-Ray 构建块和约定，这些内容是为一个真实的核心人物（四个磁性基态渲染图加上五个用于经费申请的概念图标部件）开发的，并经过多轮视觉审查完善。当交付物是需要放入他人阅读的文档中的独立图表或图标时（而不是 UI、不是网页，而是一张渲染图像），即可使用此技能。
为什么选择 POV-Ray，以及它能带来什么
POV-Ray 场景是纯文本，这意味着：它们易于参数化（循环处理 N 个原子、生成晶格、扫描参数）、易于从可重用宏组合、并且易于以不同分辨率重新渲染而无需重复工作。输出是一张平坦、精确可控的光栅图像（而非交互式 3D 场景）——这正是论文、幻灯片和经费 PDF 所需的格式。
快速开始
- 首先
#include "common.inc"——设置相机、柔和的三点光源、背景/透明度和共享材质预设。查看它一次；注释解释了每个选择背后的 原因（如果你需要偏离它，这一点很重要）。 - 根据需要引入以下文件：
molecule.inc——原子（sv_atom）、键（sv_bond）、矢量箭头（sv_arrow）wave.inc——振荡管状体：传播波和模糊的“抽象相互作用”连接器是同一个宏（sv_wave_tube），只是参数不同glow.inc——用于任何应显示为发光/热/高能效果的层叠光晕技巧（sv_glow_sphere）orientation_color.inc——将方向/角度映射到感知上不同的颜色（sv_orientation_colour/sv_colour_wheel），用于方向本身即为数据的情况（自旋角、流动方向、相位）
- 使用
scripts/render.sh <scene.pov> [W] [H] [out.png]进行渲染，而不是直接调用povray——它会设置+UA（真实 Alpha 通道）、合理的抗锯齿、使 POV-Ray 指向此技能的assets/目录，以便你的#include无需复制文件即可解析，并且会在 Alpha 通道出现问题时发出警告（请参阅下面的陷阱——这在真实会话中曾默默地带来过麻烦）。 - 在完成前检查结果。读回 PNG（使用
Read工具）并实际查看——POV-Ray 可能会在没有任何错误的情况下愉快地渲染出有细微错误的内容（被相机帧裁剪、颜色错误、箭头重叠）。
五个部件模板
assets/widgets/ 包含五个可直接修改的场景，每个都是上述构建块的示例：
| 文件 | 展示内容 | 构建自 |
|---|---|---|
laser.pov | 传播的振荡波 + 方向箭头（光、声音、任何信号） | sv_wave_tube（开放、无锥度） |
particle_current.pov | 一行 N 个粒子，每个携带一个矢量属性，沿流动方向漂移 | sv_atom + sv_arrow + 一个流动箭头 |
thermal_grid.pov | 一个 NxN 晶格，带有小的位置抖动，根据距中心的距离从热到冷发光 | sv_glow_sphere + 抖动网格循环 |
interaction_triangle.pov | N 个物体通过模糊、发光、非刚性的“相互作用”线连接（区别于物理键） | sv_atom + sv_wave_tube（锥形、抖动、发光） |
复制最接近你所需内容的文件，并在接触几何体本身之前更改顶部的声明参数（颜色、数量、间距、幅度）——所有四个文件都编写为“旋钮”位于顶部。
对于真实的分子/晶体结构（而非概念图标），跳过部件直接使用 molecule.inc：循环处理原子坐标，调用 sv_atom 和 sv_bond，对每个原子的矢量（自旋、偶极矩、位移）使用 sv_arrow，如果该矢量的 方向 本身是有意义的数据值得进行颜色编码，则使用 sv_orientation_colour。
值得保留的设计约定
这些并非随意制定——每一个都源自真实的视觉审查轮次：
- 白色背景，真实 Alpha 通道（
+UA）。 渲染图可以直接放置到幻灯片/页面/图上，无需可见边框，并且无论背景如何，都能与其他面板整洁地组合。 common.inc中的三点光源，而非单个点光源。一个硬光源看起来像渲染的 3D 物体（“剪贴画”）；而软的主光+辅助光+辅助光源则看起来像一幅抛光、亚光、印刷的插图。在多面板图的所有面板上保持 相同 的光源，使它们看起来像同一系列——一个与相邻面板照明不同的面板，即使几何风格匹配，看起来也像一个不匹配的贴纸。- 键/刚性连接器会获得一个小的远离相机的 Z 偏移（
sv_bond的ZOffset参数），当键和箭头可能在同一区域附近平行运行时使用——否则它们会发生 Z 冲突，或者键明显切入箭头。偏移足够小（在典型场景比例下为 0.15-0.25 单位），以至于没有人会有意识地注意到它的存在。 - 箭头比“接触”长度短 10-20%。 如果两个矢量箭头在共享点相遇，缩小
Scale直到它们的尖端彼此错开——接触的尖端看起来像渲染故障，而不是数据。 - 抽象 vs. 物理连接使用不同的视觉语言。 真实键（
sv_bond）：刚性、清晰、亚光。抽象耦合/力/相关性（带有Glow=true的sv_wave_tube）：波浪形、柔边、发光。不要将你无法指出存在字面意义上原子-原子轨道重叠的相互作用绘制成物理杆状物。 - 稍微扭曲“通用”排列。 完美的等边三角形或完美的规则网格看起来像剪贴画。小的、有意的非规则性（参见
interaction_triangle.pov的三角形，或thermal_grid.pov的抖动）即使是并非模拟输出的示意图标，也看起来像“真实系统”。
当你渲染真实的模拟数据而非图标时
如果原子位置/矢量来自真实的模拟（DFT、分子动力学、微磁学等），上述图标部件的约定仍然适用，但你需要用真实坐标数据填充 sv_atom/sv_bond/sv_arrow 调用，而非手动选取值。实用说明：
- 通过原子对之间的距离截断生成键，而非手动。
- 如果你想显示一个真实的、物理上周期性的平铺补丁（比一个模拟单元更大的区域），而无需重新运行昂贵的模拟，并且属性均匀平铺（对于大多数简单的有序基态成立），通常可以通过几何方式复制已经收敛的小单元结果，而不是重新模拟更大的系统——但首先请验证在你的情况下属性确实在单元之间没有变化。
- 裁剪到物理上有意义的边界（例如，一个完整的配位壳/单元基序），而不是一个任意的矩形——裁剪本身应该传达关于结构的某种真实信息。
故障排除
在花时间调试 POV-Ray 解析错误或看起来不正确的渲染之前，请阅读 references/troubleshooting.md——它列出了构建此技能时已经遇到的具体陷阱（看起来像普通变量名的保留 SDL 单词、静默的 Alpha 透明度错误、POV-Ray 的相机手性、sphere_sweep/array 作用域问题）。大多数 POV-Ray 错误消息对于语法问题是诚实的，但无法解释为什么从普通程序员的角度看它看起来是这样；该文件的存在是为了让你不必重新发现同样的一小堆陷阱。
有关每个宏参数和设计原理的更完整示例说明（以及比此处容纳的更多的示例调用），请参阅 references/techniques.md。