VTST专题

VTST本地KDB的导入、查询与路径预览

用已有Al13 NEB三结构演示五个原版Perl KDB命令、局部环境存储、候选过渡态与MODECAR输出、匹配阈值和32帧路径预览。

更新于 2026-11-16约 7 分钟阅读按任务与环境选择适用配置
阅读本篇目录

下载完整三结构、模式初猜、实际数据库与候选结构、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

已有Al13三结构及原生KDB局部路径预览

本例复用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帧,换体系时需要调整相应读取范围。

需要根据你的体系选择资源?联系讨论计算需求。实际可用软件与权限,以当前账户和运行环境为准。

查看配图

放大后可滚动查看细节,按 Esc 关闭。

100%查看原图 ↗