VTST本地KDB的导入、查询与路径预览
用已有Al13 NEB三结构演示五个原版Perl KDB命令、局部环境存储、候选过渡态与MODECAR输出、匹配阈值和32帧路径预览。
阅读本篇目录
下载完整三结构、模式初猜、实际数据库与候选结构、CSV和两张图(ZIP)。已有一组反应前态、过渡态与后态时,本地KDB可以保存局部几何环境,再给相似结构生成过渡态初猜。先导入,再查询,最后将合适的候选交给dimer或其他过渡态方法继续优化。
1 先查看已有结果#
解压进入vtst-local-KDB:
bash read.sh
bash plot.sh
cat analysis/VTST-KDB-suggestions.csv
head -8 analysis/VTST-KDB-source-mapping.csv
ls analysis/figures

本例复用Al表面吸附原子迁移的已有NEB结果,三个结构各13个Al,底部8个原子固定。导入后数据库保留7个局部原子,包含移动的吸附原子与邻近环境。这里没有重算NEB,也没有新增DFT或MD。
2 准备前态、后态、过渡态和模式#
ls inputs
cat inputs/MIN1
cat inputs/SADDLE
cat inputs/MIN2
cat inputs/MODECAR
前三个文件均为POSCAR格式,原子顺序相同:MIN1是前态、MIN2是后态、SADDLE是已有NEB中间参考。以MIN1为例:
Al
1.000000000000000
5.7275649276110352 0.0000000000000000 0.0000000000000000
0.0000000000000000 5.7275649276110352 0.0000000000000000
0.0000000000000000 0.0000000000000000 24.1499999999999986
Al
13
Selective dynamics
Direct
0.0000000000000000 0.0000000000000000 0.3726708074534173 F F F
0.5000000000000000 0.0000000000000000 0.3726708074534173 F F F
0.0000000000000000 0.5000000000000000 0.3726708074534173 F F F
0.5000000000000000 0.5000000000000000 0.3726708074534173 F F F
0.2500000000000000 0.2500000000000000 0.4565217391304373 F F F
0.7500000000000000 0.2500000000000000 0.4565217391304373 F F F
0.2500000000000000 0.7500000000000000 0.4565217391304373 F F F
0.7500000000000000 0.7500000000000000 0.4565217391304373 F F F
0.9974573816958793 0.9974573794319629 0.5305194839058829 T T T
0.5025426226035357 0.9974573799760820 0.5305194807901485 T T T
0.9974573805245049 0.5025426200385467 0.5305194799669127 T T T
0.5025426207851937 0.5025426214565997 0.5305194838828144 T T T
0.2500000009692897 0.2500000007395407 0.6000417657482197 T T T
MODECAR必须与完整结构一一对应,每个原子一行、每行三个笛卡尔分量。本例使用第13个原子的+x单位方向作为迁移模式初猜,其余12行全为0:
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
0 0 0
1 0 0
这是为了演示模式随局部环境一起保存和旋转,不是通过Hessian求得的负频模。准备脚本可重新生成这份明确的初猜:
/public/toolkit/miniconda3/envs/ase-3.29.0/bin/python prepare-mode.py
diff inputs/MODECAR inputs-prepared/MODECAR
换体系时,优先使用自己的可靠过渡态和实际模式;不能给任意结构附上本例单位方向,就认为得到了真实过渡态。
3 建立自己的本地数据库#
在一个新的示例目录中执行:
module load apps/vtstscripts/1040
mkdir local-kdb
export VTST_KDB="$PWD/local-kdb"
kdbaddprnew.pl inputs/MIN1 inputs/MIN2 inputs/SADDLE inputs/MODECAR
ls local-kdb/Al/0
cat local-kdb/Al/0/mobile
head -10 local-kdb/Al/0/saddle.xyz
注意参数顺序是前态、后态、过渡态、模式。VTST_KDB显式指向自己的示例目录,后续导入、查询和预览都使用这个位置;无需部署网络数据库。
旧版导入命令kdbaddpr.pl也已实跑。比较两种入口时,分别使用新数据库目录:
mkdir local-kdb-old
VTST_KDB="$PWD/local-kdb-old" \
kdbaddpr.pl inputs/MIN1 inputs/MIN2 inputs/SADDLE inputs/MODECAR
本例两种导入方式均保存一个Al/0过程,保留7个局部原子。mobile输出的6是缩减后结构从0开始编号的第7个原子,对应原始13原子结构中的第13个原子,不能直接把6当成完整POSCAR里的原子序号。
数据库中的三个XYZ已处理局部周期映像,并用局部过渡态的中心统一平移。它们的坐标原点与原始POSCAR不同,不应直接逐坐标相减来判断结构是否改变。VTST-KDB-source-mapping.csv给出本例7个局部原子与原始原子的对应关系。
4 查询候选过渡态#
保持上一节的VTST_KDB指向local-kdb,使用新工作目录保存输出:
mkdir query-strict
cd query-strict
kdbquerynew.pl --score=0.001 ../inputs/MIN1
ls kdbmatches
head -12 kdbmatches/SADDLE_0
cat kdbmatches/MODE_0
cd ..
输出中的SADDLE_N是完整13原子的候选过渡态结构,MODE_N是对应的完整模式初猜,.done_N表示该候选写出完成。编号从0开始。查询会重建当前目录的kdbmatches,因此请为不同条件建立不同目录。
旧版查询及新版默认阈值也已实跑:
mkdir query-old
cd query-old
kdbquery.pl ../inputs/MIN1
cd ..
mkdir query-default
cd query-default
kdbquerynew.pl ../inputs/MIN1
cd ..
本例旧版产生2个候选;新版默认score=0.1产生3个;新版收紧到score=0.001后产生2个。候选数量取决于局部匹配、对称性和阈值,不等同于独立反应通道数。
| 查询条件 | 候选编号 | 吸附原子高度(Å) | 与原参考的成对距离集合最大差(Å) |
|---|---|---|---|
| query-old | 0 | 14.89051227 | 6.15407e-07 |
| query-old | 1 | 14.89051261 | 9.72366e-06 |
| query-new | 0 | 14.89051191 | 8.94958e-07 |
| query-new | 1 | 14.89051261 | 9.72366e-06 |
| query-new | 2 | 14.88903370 | 0.00616797 |
| query-new-score001 | 0 | 14.89051191 | 8.94958e-07 |
| query-new-score001 | 1 | 14.89051261 | 9.72366e-06 |

表中的成对距离按最小周期映像计算并排序,用于比较本例对称相关结构的几何,不是KDB内部的score。默认查询的第3个候选与参考有约0.00617 Å差别,说明它是近似初猜;收紧阈值后不再保留这个候选。全部输出均保留,未将候选直接当成新弛豫过渡态。
本例各候选保留底部8个原子的固定位置和约束,模式范数为1。得到候选后,应在自己的工作目录继续dimer/过渡态优化,并检查受力与振动模式;KDB本身不计算新的能垒、前因子或速率。
5 生成局部路径预览#
mkdir preview
cd preview
kdbquerymovie.pl Al
head -11 kdbmovie/movie-0.xyz
cd ..
生成的movie-0.xyz每帧7个局部原子,共32帧:前16帧沿前态到过渡态线性插值,后16帧沿过渡态到后态线性插值。第16帧是过渡态,最后一帧尚未到达后态端点,这是本版循环的实际采样方式。
这段预览用于检查几何变化,不是新的优化路径或MD轨迹;不能从帧号推导时间,也不能为插值帧套用未经计算的DFT能量。它显示缩减后的局部环境,和查询输出的完整13原子SADDLE_N用途不同。
6 运行整套示例#
cat run.slurm
sbatch run.slurm
# 完成后
bash read.sh work-new analysis-new
bash plot.sh analysis-new
cat analysis-new/VTST-KDB-suggestions.csv
脚本在新的work-new中分别建立旧、新数据库,执行两种导入、三种查询条件和预览;保留附带参考结果。CPU模板预留56核,实际单线程、不使用GPU;本例六次原生后处理合计约3秒,不含排队时间。
VTST scripts版本1040,使用系统Perl5.38.2解释执行,无独立编译器要求;NumPy负责坐标和数据读取,Matplotlib绘图。本篇使用的是随VTST安装的Perl本地几何库入口,Python远程KDB客户端不是这套流程的依赖。
命令以VTST官方脚本说明和集群1040版实际接口为准。包内读取器针对本例13原子、7原子局部环境和32帧,换体系时需要调整相应读取范围。