参数速查与计算审阅

INCAR 规定计算方法与控制项，POSCAR 描述结构，POTCAR 提供与元素顺序对应的 PAW 数据，KPOINTS 或 KSPACING 决定采样。一个标签写得合法，不代表这些文件彼此一致。读参数时依次确认：它控制什么物理或数值步骤、值的类型和单位、何时生效、与哪些输入有关，以及你的程序版本是否支持。

默认值表示“不写此项时程序怎样做”，并不表示它最适合你的材料。有些默认值还随其他标签变化，例如是否开启杂化泛函、是否读取成功的波函数，都会影响后续行为。教材中的某个数字同样只是带前提的起点；计算报告应记录实际采用的设置和收敛证据，而不是只写“采用默认精度”。

SYSTEM = Describe your model
ENCUT = 520       # eV; replace after convergence tests
EDIFF = 1E-6      ! electronic stopping threshold, eV
ISMEAR = 0; SIGMA = 0.05
LWAVE = .TRUE.

此处仅示范普通赋值、注释与分号，不足以独立定义一个可靠任务。逻辑量通常写成 .TRUE. 或 .FALSE.；数组既有逐原子项，也有逐物种项，不能混用。例如 MAGMOM 通常按原子序列展开，而 LDAUL、LDAUU、LDAUJ 按 POTCAR 物种顺序对应。4*0.0 表示四个相同数组值，并不表示算术乘法后只得到一个数字。

下面速查表整理常用项，不声称包含全部 VASP 参数。每项链接到官方 INCAR 文档或对应标签页；涉及特殊算法时，请继续阅读其适用性与版本说明。

可按标签、关键词或类别查找。先看“作用”和“前提”，再决定数值；“精度”类解决数值表示，“电子/磁性”类还可能改变所求的物理状态，不能把它们统一理解为越大越好。

严格能量比较要保持一致的泛函、PAW 数据、截断策略及能量定义。改变 U、交换混合比例或电子数，常意味着改变研究模型，不能按总能越低就宣称方法越好。所有关键比较都要落回目标性质的误差与收敛。

下面列出常见工作流的依赖。所有行都仍需要相容的结构、方法、PAW 数据与采样；表中“额外文件”不是可以省略基本输入的意思。优先为不同任务建立独立目录，留下明确的上一阶段来源。

版本例子：依赖动能密度的 meta-GGA 固定密度能带流程，在 VASP 6.6.0 前后有区别；新版本需按官方说明保留相应动能密度信息。不要把旧 PBE 教程的目录复制法当作所有泛函通用操作。详见官方能带步骤及本课电子结构任务。

把 INCAR 文本粘贴到下方，工具会识别普通 TAG = VALUE、# 与 ! 注释，以及同一行的分号分隔，提示重复标签和部分常见组合问题。文本在本页浏览器内处理；工具不会提交集群任务，也不会运行 VASP。

例如看到“检查 LMAXMIX”，应回到所研究的 d/f 轨道、前一步电荷保存设置与后一步固定密度流程，而不是机械复制一个数。看到“NEB 实现需确认”，应核对是否安装相应补丁与优化器，不能把 VTST 的参数直接写给未修改的原生程序。

增加核数不总能缩短时间。电子态之间要正交化，FFT 需要通信，文件读写也有成本。MPI rank 是进程，OpenMP 线程是进程内的并行单元，GPU 是另一种计算设备；提交脚本里的任务数不能不加区分地照抄成 NCORE。

对常见、没有额外图像或特殊算法分组的 CPU MPI 任务，KPAR 把进程划分给 k 点组，NCORE 规定一条能带由多少进程协作，NPAR 是对应的能带分组数。此时可用关系 NPAR = 总 MPI ranks / (KPAR × NCORE) 帮助检查整除关系；存在 IMAGES 或其他算法分组时要先扣除相应层次。这是分工关系，不是建议把三个参数都同时写入。

NCORE 与 NPAR 不应同时设置。若并存，官方说明 NPAR 因兼容旧输入而优先；现代 CPU MPI 调优通常优先使用 NCORE。应在同一代表性结构、同一物理参数下用短任务比较总耗时、每电子步耗时与峰值内存，再选合适组合。不能让一次测试改变了 NBANDS、收敛步数或硬件占用，却把全部差异归因于并行参数。

GPU 构建也并非所有算法都在 GPU 上执行。核实具体 VASP 版本、GPU 实现、编译库与功能支持后，再用输出确认实际设备分配。KPAR 可减少部分通信，但过多分组可能负载不均或增加内存压力；Γ-only 任务没有很多 k 点可供分配。相关最新条件见NCORE、KPAR、GPU 构建与运行说明。

重启文件是某一步计算状态的保存，不是对任意新任务都合适的加速包。WAVECAR 保存波函数相关信息，CHGCAR 保存电荷与 PAW 单中心信息，CONTCAR 保存任务进行后的结构。它们是否完整、是否来自已收敛状态、能否与新晶胞、采样、电子数、方法和程序构建兼容，都需要核对。

从 CONTCAR 开始新一轮优化时，先检查结构、原子顺序与约束再写为新目录的 POSCAR。对动力学，速度和其他延续状态也可能重要；只保留坐标重新随机速度，不能叫作原轨迹的严格连续延长。进行文件复制前应保留上一轮日志，防止同名 OUTCAR 把导致问题的证据覆盖掉。

建议每个计算目录附一份报告：结构来源与哈希、软件与数据集标识、提交脚本、全部关键输入、重启来源、停止判据、收敛曲线、后处理版本和结果单位。POTCAR 受许可管理，公开复现记录可写数据集名称、生成信息和校验值；不应把受限数据文件作为教学下载随意分发。

重启设置细节见ISTART与ICHARG。重新从头运行和读取旧状态运行应得到相容的目标量；若差异明显，先调查局部磁态、方法变化、PAW 单中心信息与收敛，再谈“机器误差”。

“计算得到吸附能 −0.6 eV”缺少必要上下文：相对于什么参考态、几种构型里哪一个、是否含零点能和熵、单位按一次吸附还是每个原子？用下列模板可以把这些问题放在计算开始前，而不是论文写作时再倒推补齐。

研究问题：比较 A、B 两个明确的候选构型。
目标量：写出计算定义、符号约定及单位。
模型：写明晶胞、组成、磁态、环境与结构来源。
方法：软件版本、PAW 数据、泛函、关键参数及依据。
数值检查：记录收敛测试及目标量变化，不只写最终阈值。
结果：写出数值、误差尺度、备选解释与验证范围。
可复现材料：输入、输出、提交脚本和后处理方法的保存位置。

把“预测”“模拟”和“实验验证”分开书写。例如“在给定 PBE+U 模型与超胞内，A 的电子能比 B 低”是一项受条件限定的计算结论；它没有自动证明实际样品在有限温度和气氛下只生成 A。记录这种边界不会削弱结果，反而让下一步验证更明确。

完整记录模板可在本页下载区获取。回到课程首页，按自己的研究问题选择下一项练习。

从 OUTCAR 提取一份可核对的摘要

配套的 inspect_vasp_run.py 只读取文件，不修改计算目录。它提取最后的 TOTEN、无熵能量与 sigma→0 能量、最后一组原子力，以及程序的停止消息和文件 SHA-256。不同能量字段有不同含义，做差前必须统一约定。

使用整包示例时，从解压后的示例根目录运行下行命令，脚本位于 tools 子目录；若单独下载脚本，则把命令中的脚本路径改为实际保存位置。将 /path/to/run/OUTCAR 替换为自己的输出文件。

python tools/inspect_vasp_run.py /path/to/run/OUTCAR > summary.json

脚本需要 Python 3，不依赖额外软件包。若输出尚未写完，某些字段会是 null。最大力对所有读到的原子取模，包括被固定的原子，因此不能不加区分地拿它代替实际约束下的优化判据。

先读文件说明与对应章节，再补齐模型、POTCAR 与前置计算。后缀为 .template 的文件包含待改参数，不能原样提交。

正文为独立整理的学习说明。标签含义和版本差异以与你的程序版本对应的官方文档为准。

1. VASP Wiki: INCAR
2. VASP Wiki: Band-structure calculation using DFT
3. VASP Wiki: GPU ports of VASP
4. VASP Wiki: ENCUT
5. VASP Wiki: PREC
6. VASP Wiki: EDIFF
7. VASP Wiki: EDIFFG
8. VASP Wiki: LREAL
9. VASP Wiki: ADDGRID
10. VASP Wiki: LASPH
11. VASP Wiki: KSPACING
12. VASP Wiki: KGAMMA
13. VASP Wiki: ALGO
14. VASP Wiki: NELM
15. VASP Wiki: ISMEAR
16. VASP Wiki: SIGMA
17. VASP Wiki: NBANDS
18. VASP Wiki: NELECT
19. VASP Wiki: ICHARG
20. VASP Wiki: ISTART
21. VASP Wiki: GGA
22. VASP Wiki: METAGGA
23. VASP Wiki: IBRION
24. VASP Wiki: NSW
25. VASP Wiki: ISIF
26. VASP Wiki: POTIM
27. VASP Wiki: PSTRESS
28. VASP Wiki: ISYM
29. VASP Wiki: SYMPREC
30. VASP Wiki: ISPIN
31. VASP Wiki: MAGMOM
32. VASP Wiki: LNONCOLLINEAR
33. VASP Wiki: LSORBIT
34. VASP Wiki: SAXIS
35. VASP Wiki: LDAU
36. VASP Wiki: LDAUTYPE
37. VASP Wiki: LDAUL
38. VASP Wiki: LDAUU
39. VASP Wiki: LDAUJ
40. VASP Wiki: LMAXMIX
41. VASP Wiki: LWAVE
42. VASP Wiki: LCHARG
43. VASP Wiki: LORBIT
44. VASP Wiki: NEDOS
45. VASP Wiki: EMIN
46. VASP Wiki: EMAX
47. VASP Wiki: LVHAR
48. VASP Wiki: LAECHG
49. VASP Wiki: LHFCALC
50. VASP Wiki: AEXX
51. VASP Wiki: HFSCREEN
52. VASP Wiki: IVDW
53. VASP Wiki: LDIPOL
54. VASP Wiki: IDIPOL
55. VASP Wiki: DIPOL
56. VASP Wiki: IMAGES
57. VASP Wiki: SPRING
58. VASP Wiki: MDALGO
59. VASP Wiki: TEBEG
60. VASP Wiki: LANGEVIN_GAMMA
61. VASP Wiki: NCORE
62. VASP Wiki: NPAR
63. VASP Wiki: KPAR