VTST旧AKMC目录的配置、状态与KDB归档
运行akmcupdate、akmcreset和kdbaddvpr,查看配置补全、状态重置和模式文件优先级,给出完整示例目录及修改前后文件。
阅读本篇目录
下载五组输入目录、实际输出、三份CSV和两张图(ZIP)。整理VTST旧AKMC格式的目录时,这三个工具可分别补全配置、生成新的状态清单、把已有过程写入本地KDB。本篇先展示实际文件变化,再说明终端操作。
示例目录中的结构复用已完成的Al13 NEB数据;config片段与st.dat状态行是明确准备的教学输入,用来实际运行这些文件工具,不表示完成了一段AKMC搜索或KMC时间演化。
1 读取已有结果#
解压进入vtst-AKMC-local-files:
bash read.sh
bash plot.sh
cat analysis/VTST-AKMC-config-changes.csv
cat analysis/VTST-AKMC-status-transitions.csv
cat analysis/VTST-AKMC-KDB-mode-selection.csv
三个CSV分别对应配置变化、状态变化和模式选择。实际操作建议先复制自己的目录;配置工具会改写当前目录的config,归档工具会在指定本地数据库写入文件。
2 用akmcupdate补全旧配置#
module load apps/vtstscripts/1040
cp -a inputs/config-add demo-config
cd demo-config
cat config.before
akmcupdate.pl
cat config
diff -u config.before config
cd ..
这里diff在文件不同时会返回1,表示发现差别,可直接阅读输出。实际输入片段为:
# Example configuration fragment, not a full AKMC setup
NumSearches = 4
DisplaceAlgo = 2
运行后:
NumSearches = 4
DisplaceAlgo = 2
DisplaceRange = 3
NN_rcut = 2.6
MaxCoordNum = 8
已经存在的DisplaceAlgo=2被保留,只补缺少的DisplaceRange、NN_rcut和MaxCoordNum。这些是该版脚本写出的旧默认值,不是对Al或其他材料的推荐扰动参数。
这条修改分支会按键 = 值重写内容,原有注释不会保留。若四个字段原本齐全,脚本不改写文件;config-keep这一组连同注释均逐字节保持原样:
cp -a inputs/config-keep demo-config-keep
cd demo-config-keep
akmcupdate.pl
diff config.before config
cd ..
本例只是配置片段,不能直接把它当成完整AKMC控制器配置。
3 用akmcreset生成新的状态清单#
cp -a inputs/reset-status demo-reset
cd demo-reset
cat st.dat
akmcreset.pl st.dat
cat st_reset_bad.dat
diff st.dat.before st.dat
cd ..
输入的三条示例过程为:
st0001 0
status done
dynmat done
NumSearchesLeft 0
numprst 3
pr0001 done bad 0.94779772 old1 old2
pr0002 done bad 0.94779772 old1 old2
pr0003 done good 0.94779772 old1 old2
实际新输出:
st0001 0
status done
dynmat done
NumSearchesLeft 0
numprst 3
pr0001 quench promising 0.94779772 na na
pr0002 done bad 0.94779772 old1 old2
pr0003 done good 0.94779772 old1 old2

只有done bad且两个末态结构文件均存在时,脚本才把它改为quench promising,并把两个引用字段改为na。本例第一行满足条件;第二行缺少mins/min2/final/CONTCAR;第三行原本是done good,因此后两行保持原状态。
脚本写的是新文件st_reset_bad.dat,原来的st.dat不变,也没有提交计算或重新优化结构。清单中的0.94779772 eV取自已有NEB参考差值,运行这个工具不会重新计算能垒。
如果要将新清单用于真正的后续计算,应先检查每条状态和对应目录。这里没有启动AKMC总控,也不把改写状态文件当作已完成的科学计算。
4 按过程目录归档到本地KDB#
该入口读取的主要布局为:
st.dat
pr0001/
final/
CENTCAR
MODECAR
NEWMODECAR # 存在时优先使用
mins/
min1/final/CONTCAR
min2/final/CONTCAR
CENTCAR是中心过渡态结构,两个CONTCAR是前、后态。完整的KDB概念和直接文件导入方法见本地KDB导入、查询与路径预览。
先运行仅有MODECAR的一组:
cp -a inputs/archive-modecar demo-archive
cd demo-archive
export VTST_KDB="$PWD/database"
kdbaddvpr.pl pr0001
ls database/Al/0
cat database/Al/0/mobile
cat database/Al/0/.mode.car
cd ..
再比较同时有两个模式文件的情况:
cp -a inputs/archive-newmodecar demo-newmode
cd demo-newmode
export VTST_KDB="$PWD/database"
tail -1 pr0001/final/MODECAR
tail -1 pr0001/final/NEWMODECAR
kdbaddvpr.pl pr0001
tail -1 database/Al/0/.mode.car
cd ..

第一组的MODECAR在第13个原子的+x方向为1;第二组特意把MODECAR设为+y,而NEWMODECAR设为+x。实际归档选择了NEWMODECAR的+x,说明不能只修改旧MODECAR却忽略目录中已经存在的新模式文件。
这两个模式都是用于解释文件选择的单位方向初猜,不是新增Hessian计算。两组归档保存了相同的实际前态、后态、过渡态几何;本地过程缩减为7个原子,mobile=6对应缩减结构从0开始编号的第7个原子,即原始完整结构的第13个原子。
kdbaddvpr.pl内部调用原版kdbaddpr.pl,因此要加载同一套VTST脚本路径。VTST_KDB始终指向自己的新目录;本例不使用远程KDB服务。
5 重新运行整套五组#
/public/toolkit/miniconda3/envs/ase-3.29.0/bin/python prepare-directories.py
ls inputs-prepared
cat run.slurm
sbatch run.slurm
# 完成后
bash read.sh work-new analysis-new
bash plot.sh analysis-new
cat analysis-new/VTST-AKMC-status-transitions.csv
准备脚本只构造五组目录与教学清单,并核对其与实际输入一致;运行脚本在新的work-new工作,不覆盖参考结果。CPU模板预留56核,实际单线程、不使用GPU,五次原生文件操作合计约0.54秒,不含排队时间。
VTST scripts1040,系统Perl5.38.2解释执行,无独立编译器要求;NumPy读取模式与表格,Matplotlib绘图。上述工具管理的是旧格式文件和局部归档,不代表旧AKMC自动作业控制器已适配当前Slurm。常规过渡态计算可继续按本站NEB、dimer教程提交自己的任务。
相关基础见VTST官方脚本说明,具体字段与副作用以集群1040版的akmcupdate.pl、akmcreset.pl、kdbaddvpr.pl实际行为为准。