输出文件¶
每次运行会生成两类文件。一类沿用 VASP 的文件格式,方便用你熟悉的工具查看;另一类是 JSON, 记录这次计算实际用了什么、算出了什么。两者有出入时,以 JSON 为准。
这些文件只是格式和 VASP 相同,数值上和 VASP 计算没有对应关系:没有 SCF、k 点、ENCUT 和
POTCAR,绝对能量只对产生它的模型有意义。OUTCAR 主要给人看,也方便读取 VASP 输出的工具使用;
程序处理请读 JSON。
单点与结构优化¶
直接写在输出目录里:
OUTCAR 类似 VASP 的能量、力、应力报告
OSZICAR 每一步的能量与力(仅结构优化)
CONTCAR 最终结构(单点时是输入结构的副本)
mliport_results.json 结果,以及模型的身份
resolved_config.json 配置,以及每个值的来源
run.log 运行的实时日志
mliport_results.json 里,物理量在 calculation.results 下(能量、每原子能量、力及其统计、
应力和压强),结构在 calculation.system 下,结构优化的收敛情况在 calculation.optimization
下(converged、nsteps、fmax_threshold)。
运行期间输出目录会被锁定。如果目录里已经有结果(之前的计算,或者 VASP 自己的 OUTCAR、
CONTCAR),程序会拒绝写入,确定要覆盖时加 --overwrite。
mliport run 默认写进 INCAR 所在文件夹下的 results/(见配置里的
“任务文件夹”);--output 或 OUTPUT_DIR 仍然可以指定别的目录。其他子命令在不指定的情况下
照旧写进当前目录。
分子动力学¶
MD 的完整原始数据和 VASP 格式的导出文件分开存放:
raw/trajectory.traj 标准 ASE 轨迹
raw/md.csv 逐帧标量:能量、温度等
raw/mliport_results.json
vasp/OUTCAR, vasp/CONTCAR, vasp/XDATCAR
artifacts.json 清单:文件、单位、可观测量定义、哈希
resolved_config.json
run.log
artifacts.json 写明了单位和每个物理量的定义,例如 forces_raw_eV_A(原始的力)和
forces_applied_eV_A(施加约束之后的力),以及构型应力和总应力。任何 ASE 轨迹都可以用
mliport convert-xdatcar 转成标准的 XDATCAR。
NPT 运行会改变晶胞,标准 XDATCAR 无法表示,所以不写 vasp/XDATCAR(原因会记入日志)。raw/trajectory.traj 保留每一帧的晶胞和动量,raw/md.csv 增加体积和总压强(含动能项),清单里把该轨迹标为变胞、不可用于输运分析。详见 MD。
XDATCAR 的 PBC 限制: 标准 VASP XDATCAR 不保存 ASE 的 pbc 掩码。
非三维周期性 MD 导出时会给出信息丢失警告,原始掩码另存在 artifacts.json
的 trajectory.pbc 中。加载与该清单匹配的 Mliport vasp/XDATCAR 时,
分析程序会恢复原始 PBC。没有匹配来源元数据的独立或旧版 XDATCAR,其
PBC 无法确认;即使 ASE 默认读取为三维周期性,也不得据此放行体相
RDF、MSD 或输运分析。有原始数据时请使用 raw/trajectory.traj。
NEB¶
neb_results.json 能量、力、收敛状态、势垒数值
run_context.json 运行信息,包括 gradient_preflight
resolved_config.json
artifacts.json
checkpoints/ 完整能带检查点(band.traj + checkpoint.json)
vasp_path/ 每个 image 一个 POSCAR,可用 VASP 的 NEB 工具处理
分析¶
mliport analyze 的结果写在 <run>/analysis/<task>/<analysis-id>/ 下,包括 JSON、CSV,有图
的分析还会输出 PNG 和 SVG,同时记录这次分析的设置。详见轨迹分析。
单位¶
| 物理量 | 单位 |
|---|---|
| 时间 | fs |
| 长度 | Å |
| 能量 | eV |
| 力 | eV/Å |
| 应力 | eV/ų |
| 压强 | GPa |
| 温度 | K |
计算记录¶
resolved_config.json 记录每个参数的最终值和来源(内置默认值、设置文件、别名、profile、
INCAR 或命令行),据此可以准确复现或核查一次计算。
结果文件和 run_context.json 里还记录了:
- 模型信息:
model_type、路径、task、head、精度、后端和框架版本,能获取时还有model_sha256; - 设备:请求的和实际使用的,能获取时还有 GPU 的 UUID;
- 软件版本:运行这次计算的 mliport commit;
- 哈希值:输入结构、模型和输出文件的哈希,分析和验证记录会用到它们。
请求的设备与实际设备¶
请求 cuda:0 的运行,记录的实际设备可能是另一个编号或者一个 UUID。写论文方法部分时,以
记录的实际设备为准。如果写的是 unknown,就不要声称这次计算用了某块具体的 GPU。