VTST 本地事件库:收录与查询反应路径
用真实NH₃翻转最低点、dimer鞍点和镜像单点建立本地KDB,演示事件收录、旋转平移查询、反应结构预览及后续VASP输入准备。
阅读本篇目录
同一种局部反应可能在不同结构中重复出现。KDB(kinetic database)把已知的反应物、鞍点、产物及势垒存入事件库,再按局部几何检索可能的反应。它提供候选结构,帮助准备后续 dimer 或 NEB 计算;候选仍需要在目标体系上重新优化与计算能量。
下载完整实例、实测数据、图片与个人环境准备脚本。本例使用本地 SQLite 数据库,所有收录和查询均使用 -l,不连接外部事件数据库,也不会自动提交 VASP 作业。
1. 先看本例计算了什么#
体系是12 Å立方盒中的一个NH₃分子,4个原子。反应物和鞍点来自集群实际完成的PBE最低点及VTST dimer计算;产物把最低点沿盒子中心镜像后,实际完成一次相同电子参数的单点计算。三个结构按 00/01/02 排列,供收录工具读取,并非重新计算了一条三图像NEB轨迹。
| 结构 | 实际E0 / eV | 相对反应物 / eV |
|---|---|---|
| 反应物最低点 | -19.55007264 | 0 |
| dimer鞍点 | -19.34456559 | 0.20550705 |
| 镜像产物单点 | -19.55008583 | -0.00001319 |
正向势垒0.20550705 eV,反向0.20552024 eV。两端能量约相差0.000013 eV。这里给出的是本例参数下的计算结果,不是实验势垒。

蓝色为H,棕色为N;虚线标出三个H的平均高度。鞍点接近平面结构,最低点与镜像结构的N位于H平面两侧。图是二维投影,完整三维坐标在资料包中。
2. 解压,先读结果和绘图#
unzip vtst-local-KDB-wave1267-*.zip
cd vtst-local-KDB
bash read.sh
bash plot.sh
cat analysis/VTST-KDB-energies.csv
cat analysis/VTST-KDB-candidates.csv
reference-results 是实际输出;analysis 是从实际输出提取的数据,figures 是图片。以上命令不会重新运行VASP,也不需要POTCAR。
3. 准备个人KDB环境#
集群的VTST工具位于 vtstscripts/1040。KDB后端是独立依赖,并不是只加载VTST路径就一定能运行。本例提供个人目录内的准备脚本:
bash setup.sh
脚本从上游获取固定提交 1997cff08a26ded7f7bfb934321401293ebb2327 和NetworkX 3.5,按SHA256核对;用ASE 3.29.0环境中的Python 3.11、NumPy 2.3.5,以及GCC/gfortran 13.3.0编译Fortran接口。源码和依赖放在本目录 .kdb-env,不会修改公共Python环境。
资料包不分发第三方完整源码或编译后的后端。已有下载文件可分别放在 downloads/upstream.tar.gz、downloads/networkx-3.5-py3-none-any.whl 后再执行脚本。VTST前端直接使用集群现有脚本的个人副本。
本例对固定版本做了兼容处理:完整读取OUTCAR的E0字段、恢复显式移动原子阈值的参数传递、识别后端实际生成的候选文件名、把查询结构传入预览函数,并在修改INCAR时完整匹配参数名,保留EDIFFG。这些处理不改动势垒与几何匹配方法。后端查询限制为1个进程;本例移动阈值0.2 Å适用于这个小分子,其他反应应根据真实位移选择,不能机械照搬。
4. 收录事件,再查找候选#
bash run.sh
cat work-new/insert.log
cat work-new/query/query.log
ls work-new/query/kdbmatches
程序先复制输入到新建的 work-new,然后依次收录、查询并生成三帧结构预览。已有 work-new 会被保留,请在新的解压目录中重做。首次收录成功后,数据库 kdb.db 中有1个事件。
底层操作可以这样理解:
python kdbinsert-compatible.py -l
python kdbquery-compatible.py QUERY -l -m
这两个兼容脚本由 setup.sh 放到 .kdb-env/tools;run.sh 已经设置好后端路径和解释器,日常照着上一组短命令使用即可。
收录目录结构为:
INCAR 含IMAGES = 1,供这个三状态读取器识别目录
KPOINTS
00/POSCAR 反应物
00/OUTCAR 反应物最终E0行
01/CONTCAR 鞍点
01/OUTCAR 鞍点最终E0行
02/POSCAR 产物
02/OUTCAR 产物最终E0行
资料包中的OUTCAR摘录保留实际最终E0行,便于事件收录;镜像单点的完整OUTCAR另存于 reference-results/mirror-single-point。实际应用中,应先完成自己的最低点和过渡态计算,再收录相应结果,不应靠修改能量文本构造反应事件。
MODE.dat 是按周期性最小镜像求得的两端位移方向。它是后续搜索的初始方向,不等同于声子计算得到的本征振动模式。
5. 原始结构与旋转平移结构都能查询#
本例实际查询了两次:第一次使用原始最低点;第二次把同一结构绕z方向旋转90°,再平移 (0.7,0.4,0.2) Å。每次均找到12个候选。候选数量包含相同H原子的置换匹配及两个方向的事件匹配,因此12个候选不表示发现了12种不同反应。

后端原始候选名称类似:
SADDLE_1_0
PRODUCT_1_0
MODE_1_0
SADDLE_-1_0
PRODUCT_-1_0
MODE_-1_0
PROCESS_0 等文件把查询结构、候选鞍点、候选产物依次写入同一结构预览文件。它只是三帧结构拼接,不是动力学轨迹,也没有反应时间含义。查看结构时同时留意周期边界和元素顺序。
6. 为候选准备下一次VASP计算#
若希望同时生成dimer和产物优化目录,先把自己有许可的H/N PAW_PBE势按POSCAR中的H、N顺序准备为资料包根目录的 POTCAR,再在新的解压目录执行 bash run.sh。程序检测到POTCAR后会加上 -s,产生:
kdbmatches/KDB0/SADDLE0/
kdbmatches/KDB0/PRODUCT0/
每个目录含POSCAR、INCAR、KPOINTS及用户提供的POTCAR;鞍点目录还含MODE。资料包中的实际参考目录不含POTCAR,请自行补齐。
本例实际生成的dimer关键设置为:
ENCUT = 550
PREC = Accurate
EDIFF = 1E-7
EDIFFG = -0.02
NSW = 100
ISIF = 2
ISMEAR = 0
SIGMA = 0.05
LREAL = .FALSE.
LASPH = .TRUE.
ISYM = 0
IBRION = 3
POTIM = 0.0
ICHAIN = 2
IOPT = 2
-s 将EDIFF改为1E-7以供后续dimer使用。事件来源计算采用电子收敛1E-6、力0.02 eV/Å;准备下一次计算时仍应明确设置自己的 EDIFFG = -0.02。生成输入后核对完整INCAR,并删除与单个鞍点计算无关的 IMAGES。本例的准备脚本已在复制查询INCAR时去掉它。
KPOINTS为:
Gamma
0
Gamma
1 1 1
0 0 0
后续dimer需要使用支持相应VTST功能的VASP版本,通过自己的Slurm脚本提交;PRODUCT 目录用于普通原子位置优化,应核对 IBRION、POTIM、ISIF、EDIFFG。完成目标体系计算后,用新的最低点/鞍点能量确认反应势垒,再决定是否把新事件加入库中。
7. 什么时候适合使用#
已有可靠反应事件、需要在相近局部结构中寻找反应通道时,KDB能提供起点。数据库里没有相关机制时,查询并不会凭空找到真实鞍点;应先用NEB、dimer或其他方法探索。小周期盒子可能使同一邻居通过多个周期镜像重复出现,建立事件库时需要足够大的局部环境,不能用强制插入掩盖结构问题。
上游:Henkelman group KDB。本教程针对资料包记录的固定版本和本地模式;远程数据库账号与服务不属于本例。