分子动力学¶
mliport md 用选定的后端跑 NVE、NVT 或 NPT 动力学,生成的轨迹可以直接交给分析工具。
.venv-mace/bin/mliport md structure.cif \
--model mace-omat-0-medium.model --model-type mace \
--ensemble NVT --temp 300 --timestep 1.0 --steps 1000 \
--equilibration-steps 500 --save-interval 10 \
--output runs/md
需要一个周期性结构、一个模型,并指定后端。对分子做 MD 要用分子 task(omol / molecule),并设好
电荷和自旋。
各向同性 NPT 晶胞平衡(仅 ASE)¶
UMA/MACE/GRACE/DPA 的 --ensemble NPT 使用 ASE 的 Martyna–Tobias–Klein (MTK) 恒温恒压积分器,并非 Langevin/Bussi/NHC:
mliport md structure.cif --model model.pt --model-type mace \
--ensemble NPT --temp 800 --pressure-gpa 0 \
--npt-tdamp 100 --npt-pdamp 1000 \
--timestep 0.5 --steps 50000 --save-interval 10 \
--no-pre-relax --output runs/npt-800K
INCAR 风格文件和 settings.ini 里对应的键是 ENSEMBLE(或 MD_ENSEMBLE)= NPT、PRESSURE_GPA(别名 PRESSURE)、NPT_TDAMP、NPT_PDAMP、NPT_TCHAIN、NPT_PCHAIN、NPT_TLOOP、NPT_PLOOP;ensemble 不是 NPT 时,这些仅 NPT 使用的键会被拒绝。
--npt-tchain、--npt-pchain 默认均为 3,--npt-tloop、--npt-ploop 默认均为 1。阻尼时间单位为 fs;外压正值代表压缩(GPa),程序转换为 ASE 的 eV/ų,并记录配置。NPT 不支持约束、分子/表面(非三维 PBC)、零温度或不提供应力的模型,也不支持 NEP/原生 GPUMD。自动质心策略只在初始化时清除一次总动量,不添加 ASE FixCom;MTK 的恒温设定点考虑减少的三个动能自由度。
标准 XDATCAR 只适用于定胞轨迹。NPT 会记录原因并禁用 XDATCAR;raw/trajectory.traj 保留逐帧晶胞和动量;md.csv 保存体积和包含动能项的总压强。NPT 可变胞轨迹明确标记为不可直接用已有定胞 MSD/EH/输运分析计算扩散系数。推荐在目标温度、压强下充分平衡,统计已平衡时间窗的平均晶胞并检查收敛,然后用该晶胞另起一次定胞 NVT/NVE 生产模拟;NPT 最后一帧并不等于平均晶胞。当前保存帧不能恢复 MTK 恒温链与压强耦合内部状态,所以从该帧重启并不等价于严格续算。对各向异性晶体或相变,只有各向同性体积控制可能不足。
常用选项¶
| 选项 | 含义 |
|---|---|
--ensemble |
NVT(默认)、NVE,或各向同性 NPT(仅 UMA/MACE/GRACE/DPA 的 ASE 后端) |
--temp |
目标温度,单位 K(默认 300) |
--pressure-gpa |
NPT 外加静水压强,单位 GPa(正值为压缩,默认 0) |
--npt-tdamp、--npt-pdamp |
NPT 的 MTK 恒温器/恒压器阻尼时间,单位 fs |
--npt-tchain、--npt-pchain、--npt-tloop、--npt-ploop |
NPT 的 MTK 链长度和积分子步数 |
--timestep |
积分步长,单位 fs(默认 1.0) |
--steps |
采样阶段的步数(默认 1000) |
--equilibration-steps |
采样前在同一系综下的平衡步数(默认 0) |
--thermostat |
LANGEVIN(默认)、BUSSI 或 NHC |
--friction、--bussi-tau、--nhc-tdamp、--nhc-tchain、--nhc-tloop |
恒温器参数 |
--save-interval |
每 N 步写一帧(默认 10) |
--seed |
随机种子;省略时自动生成并记录 |
--velocity-policy、--com-policy |
速度和质心运动的处理方式 |
--pre-relax、--pre-relax-steps、--pre-relax-fmax |
MD 前先做一次简短的原子位置优化(NVT 默认开启,NVE 和 NPT 默认关闭;50 步,0.1 eV/Å) |
--fmax-abort |
任何原子受力超过这个值(eV/Å)就停止(默认 20) |
--write-outcar、--write-xdatcar、--write-trajectory |
是否写出这些文件 |
预优化没收敛会直接停止¶
如果预优化在 --pre-relax-steps 步内没有达到 --pre-relax-fmax,程序会在正式 MD 开始前停下。
从离极小点还很远的结构开始跑 MD,通常不是你想要的。报错信息会给出几种处理办法:增加步数;在有
理由的前提下放宽阈值;或者明确关闭预优化。预优化的结果记录在 md_provenance.pre_relax 里。
步长和保存间隔¶
--timestep 是积分步长,--save-interval 决定每隔多少步保存一帧。步长 1 fs、--save-interval 10
就是每 10 fs 存一帧。输运分析用的是保存帧之间的时间间隔。
平衡阶段不要计入统计:用 --equilibration-steps 设置平衡步数,只分析采样阶段。NVE 和 NVT 是不同
的动力学,两种轨迹不能放在一起平均。
恒温器和质心运动¶
--thermostat 选择 NVT 的控温方法。Langevin 带随机力,Bussi 和 NHC 是确定性的。扩散系数会受恒温器
影响,报告时要写明用的是哪种。
NHC 有几点要注意。它不能和 FixCom 或其他约束一起用。默认的 --com-policy auto(等同于
initialize_only)在初始化速度后把质心动量清零一次,之后 NHC 会保持质心动量为零。这样体系有
3N-3 个动能自由度,恒温器的设定温度相应乘以 (3N-3)/3N(记录为 nhc_set_temperature_K)。如果
设成 --com-policy none,初始速度里随机的质心动量会保留下来,整个体系会匀速漂移;分析时不扣除漂
移的话,可移动离子的 MSD 会被它主导。
约束和固定原子由计算器和运行程序施加,报告扩散结果时要写清楚。
接着跑¶
md 没有 --resume 参数。要接着之前的轨迹跑,读取一个带速度的保存帧,从它开始一次新的运行:
.venv-mace/bin/mliport md last_frame.traj --model mace-omat-0-medium.model \
--model-type mace --velocity-policy preserve --no-pre-relax --output runs/md-part2
新运行保留输入的位置和速度,不会重新按 Maxwell–Boltzmann 分布生成速度。它有单独的运行目录和记录, 第一帧和上一段的最后一帧相同(验收测试检查的就是这一点)。
什么情况下会停止¶
任何原子受力超过 --fmax-abort 或出现 NaN,计算会停止,坏掉的帧不会写进文件。写输出失败时同样会
停止。模型或结构缺失、参数组合不支持,会在 MD 开始前就报错。
验收测试在四个后端上各跑了 5 步 NVE,以及 5 步 Langevin、Bussi、NHC 的冒烟测试。这些只检查流程 和恒温器能否正常运行,不能说明温度已经平衡。
一个接近实际使用的例子¶
.venv/bin/mliport md structure.cif --model uma.pt --model-type uma --task omat \
--ensemble NVT --temp 800 --timestep 1.0 \
--equilibration-steps 5000 --steps 50000 --save-interval 10 \
--thermostat NHC \
--output runs/md-800K
输出文件的说明见输出文件:raw/ 下是完整轨迹和 md.csv,vasp/ 下是 VASP 格式的
文件,artifacts.json 列出所有文件及其单位和哈希。