VTST路径重采样:按图像编号或路径距离插值
用实际NH3路径演示nebinterp函数的线性与三次插值,生成7个结构,比较相邻图像间距,保留晶胞、原子顺序与固定标记。
阅读本篇目录
已有一条路径,想增加图像数量,或让相邻图像间距更均匀,可以先做几何重采样。这里使用已计算的NH₃路径坐标,实际运行VTST 1040 的nebinterp.py函数,比较四种插值方式。生成的是后续计算的初猜结构,没有重新计算能量或优化路径。
下载四个输入结构、28个实际生成结构、终端脚本和图片数据。使用集群已有ASE 3.29.0 Python环境中的NumPy、SciPy与Matplotlib,不需要GPU或额外电子结构计算。
1. 最短操作流程#
unzip vtst-nebinterp-wave1185-*.zip
cd vtst-nebinterp
bash read.sh
bash plot.sh
ls analysis figures
先读取随包的真实输出,观察插值前后结构。要重新生成:
bash prepare.sh
bash run.sh
ls work-new/linear-distance
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
prepare.sh复制输入到新目录,不覆盖已有work-new。本例只是四原子坐标插值和读取,不提交VASP作业。生成目录有:
linear-index/ 按原图像编号线性插值
linear-distance/ 按累计构型距离线性插值
cubic-distance/ 按累计构型距离三次插值
two-endpoint/ 仅用两个端点线性插值
每个目录中的00.vasp至06.vasp是7个结构,包含首尾端点;EXECUTION.json保留实际输出坐标和间距。资料包脚本调用已安装的原函数,共享安装不被修改。
2. 输入结构是什么#
输入来自已有NH₃ instanton路径的4个像:10 Å立方盒,前三个H固定,第四个N自由。第一个POSCAR如下:
H N
1.0000000000000000
10.0000000000000000 0.0000000000000000 0.0000000000000000
0.0000000000000000 10.0000000000000000 0.0000000000000000
0.0000000000000000 0.0000000000000000 10.0000000000000000
H N
3 1
Selective dynamics
Cartesian
5.9397308802582085 5.0000000000000000 5.0000000000000000 F F F
4.5301345598708957 5.8138308150243212 5.0000000000000000 F F F
4.5301345598708957 4.1861691849756797 5.0000000000000000 F F F
5.0000000000000000 5.0000000000000000 5.1446480131023939 T T T
N沿垂直于H平面的方向运动,首尾相对H平面的高度约为+0.144648 Å和−0.144648 Å。这里只复用其几何,原路径的能量不能自动变成新插值点的能量。

读取器核对所有生成结构的晶胞、原子顺序及Selective dynamics固定标记;本例三H的固定条件保持。初始磁矩显式设置为0,只用于几何函数输入,没有进行磁性计算,也没有从非磁性输出中虚构磁矩。
3. 图像编号与累计距离有什么区别#
按编号插值把原始4个图像放在等间隔参数0、1/3、2/3、1上。如果原路径本来不等距,加密后仍可能不等距。
按距离插值先计算相邻构型的位移范数,再以累计距离作为插值参数。本工具函数名中虽有rms_distance,实际使用的是所有原子位移拼成的欧氏范数,没有除以原子数再开方,不能直接称为通常的逐原子RMS位移。
本例原始三个间距为:
0.0825922890 Å
0.1241114482 Å
0.0825922890 Å
实际生成7个结构后:
| 方法 | 相邻间距情况 |
|---|---|
| 按编号线性 | 0.041296、0.041296、0.062056、0.062056、0.041296、0.041296 Å |
| 按累计距离线性 | 六个间距均约0.048216 Å |
| 按累计距离三次 | 本例六个间距均约0.048216 Å |
| 仅双端点线性 | 本例六个间距均约0.048216 Å |

本例几何路径接近直线,所以后三种输出可以重合。对弯曲路径,线性、三次和仅端点插值会不同;三次插值也可能产生过冲。请检查新结构是否出现过近原子、穿过不合理区域或路径偏移,再做后续计算。
4. 函数如何调用#
资料包run.py调用的是以下接口:
new_images = nebinterp.interpolate_images(
images, 7,
kind="linear",
use_image_distance_in_spline=True,
)
spacing = nebinterp.compute_image_rms_distances(new_images)
把kind改成"cubic"即为三次插值,本例提供4个原始像。只有2个输入像时,原函数会使用线性插值。7是输出结构总数,包含端点,不是直接写进VASP INCAR的IMAGES值。
当前安装版本的该函数通过模块全局变量atoms取得原子数。资料包包装入口会先指定nebinterp.atoms = images[0],再调用原函数,因此推荐使用配套run.sh。本例没有调用原脚本依赖磁性OUTCAR的主程序,也不要求用户为了坐标插值补跑磁性计算。
5. 换成自己的路径#
将inputs中的四个POSCAR替换为自己的连续路径结构,保持元素、原子顺序、原子数和晶胞一致,再检查PLAN.json与run.py中的输入数量及目标图像数。本例读取脚本用于随包模型的数值对照,不是任意体系的通用物理判据。
生成结构后,先查看结构图和间距CSV,再按目标方法准备计算。普通NEB与具有半路径约定的instanton对图像数量的定义不同,不能只复制文件数量就提交;共同INCAR、KPOINTS、POTCAR及相应方法需要的文件仍须另行准备。
随包的40项检查比较了独立分段线性/多项式结果、端点、晶胞、原子顺序、固定标记和间距,作用是帮助确认重采样操作。它们不代表新路径已经收敛,也不提供新的能垒。