PLUMED参考结构的属性映射
用实际Al13 NEB参考结构的进度、相对能量和高度标签运行PROPERTYMAP,解释映射含义、单位与邻居缓存的影响。
阅读本篇目录
下载六组完整输入、参考标签、实际输出、CSV与图片(ZIP)。路径变量教程把三幅参考结构变为平滑进度;本篇继续给参考结构附上自己的属性,让PLUMED输出这些标签的加权映射。
1 先读实际结果#
解压进入plumed-Al13-propertymap:
bash read.sh
bash plot.sh
head -8 analysis/PLUMED-Al13-property-map.csv
参考仍是已有Al13 NEB的三幅结构,原子顺序、周期映像准备和六帧示意坐标沿用路径变量例子,没有重新运行NEB、DFT或MD。
每幅参考附三个标签:
| 参考 | xi | 相对E0(eV) | 吸附原子高度标签(Å) |
|---|---|---|---|
| 1 | 0 | 0 | 14.491 |
| 2 | 0.5 | 0.94779772 | 14.891 |
| 3 | 1 | 约0.00000004 | 14.491 |
相对E0来自已有NEB结果的实际计算数据;高度按本例PDB的0.001 Å文本精度取值。xi是人为赋给参考的0、0.5、1进度标签。
2 把属性写进PDB的REMARK#
/public/toolkit/miniconda3/envs/ase-3.29.0/bin/python prepare-inputs.py
grep '^REMARK' inputs-prepared/lambda5000/properties.pdb
cat inputs-prepared/lambda5000/properties.pdb
对应三幅参考的完整标签行为:
REMARK xi=0 dE_eV=0 height_A=14.491
REMARK xi=0.5 dE_eV=0.9477977200000041 height_A=14.891
REMARK xi=1 dE_eV=4.000000330961484e-08 height_A=14.491
每行后面跟该参考的全部13个ATOM记录,并用END结束,再开始下一幅参考。完整PDB已在下载包中;各参考的原子数、编号和权重相同。属性名、等号和值之间不要加空格,例如xi=0.5。
prepare-inputs.py从原有参考能量CSV和三个单帧PDB生成这些标签文件,逐字节与本例实际输入比较;它不调用电子结构程序。生成目录已存在时停止,请保留旧结果。
3 完整PLUMED输入#
inputs/lambda5000/plumed.dat:
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
m: PROPERTYMAP REFERENCE=properties.pdb PROPERTY=xi,dE_eV,height_A LAMBDA=5000.0 NOPBC
b: RESTRAINT ARG=m.xi AT=0.5 KAPPA=2
PRINT ARG=m.xi,m.dE_eV,m.height_A,m.zzz,b.bias,b.force2 FILE=COLVAR STRIDE=1 FMT=%24.16e
PROPERTY=xi,dE_eV,height_A要与各幅PDB中REMARK的名字一致,输出相应的m.xi、m.dE_eV、m.height_A;m.zzz仍是路径MSD的对数平滑最小值,单位nm²,可以为负。
各属性是参考标签按结构相似度加权的平均。标签的单位由你定义,UNITS不会自动把名为dE_eV的数值换成kJ/mol。 本例仅对无量纲xi施加偏置,不把能量标签直接用作偏置能。
4 映射值代表什么#

LAMBDA=5000 nm⁻²时,优化中间图像的能量映射约0.943163 eV,与该幅参考的标签0.947798 eV稍有差别:有限平滑参数下,其他参考仍有权重。两幅参考的插值中点附近约映射为0.473 eV,但没有在这些中点重新计算电子能量。
这里是标签插值,没有求解电子结构,也没有训练原子势函数。不能将映射曲线中的最高点重新报告为一次DFT能垒计算,更不能把它当作自由能垒。
height_A也是存储在参考上的标签。第6帧将第2帧整体旋转平移后,全量映射的标签保持不变;它不是对当前实验室坐标系中的z坐标直接测高。若需要瞬时几何高度,应另用对应的位置或距离变量。
5 邻居列表为什么需要关注更新步长#
本例另有两种列表设置:
# inputs/nearest-two:每一步都准备在下一步重建全量列表
NEIGH_SIZE=2 NEIGH_STRIDE=1
# inputs/neighbors-cached-stride3:在重建之间使用缓存的两幅参考
NEIGH_SIZE=2 NEIGH_STRIDE=3
上面是要加在PROPERTYMAP行末的选项,不是独立动作。当前实现的列表在一步计算完成后更新,STRIDE=1这组每帧仍计算全部三幅参考,和不设近邻表的结果一致;目录名nearest-two不表示它每一帧都只取即时最近的两幅。
步长3的例子在部分帧只使用缓存集合。本例帧间跳变较大,缓存可能漏掉新的近邻,导致能量或进度映射偏离全量结果。相同内部构象若处于不同的缓存历史里,也可能得到不同的近似结果。

配套CSV的active_reference_ids列记录每帧参与的参考。对于本例只有三幅参考的小路径,直接用全量计算即可;参考数量较多时,再结合实际轨迹变化比较列表参数对速度和映射值的影响。算法见对应版本的路径公共实现。
6 自己提交并检查输出#
sbatch run.slurm
squeue -u "$USER"
# 结束后
bash read.sh work-new analysis-new
bash plot.sh analysis-new
head -8 analysis-new/PLUMED-Al13-property-map-forces.csv
六组输入包括三种LAMBDA、两种邻居设置和一组原生数值导数。脚本在新建的work-new运行,不覆盖参考文件;需要可用CPU队列资源。模板按队列规则预留56核,实际单线程、不用GPU,每组约0.6秒。
工具为PLUMED2.10.1,Intel oneAPI C++2024.2.1、IntelMPI2021.13编译,无需插件;NumPy、Matplotlib负责读取与画图。XYZ坐标使用nm,PDB使用Å,LAMBDA按MSD的nm²取nm⁻²。核心命令为:
source environment.sh
# 先复制所需inputs子目录到自己的新工作目录
plumed driver --plumed plumed.dat --ixyz trajectory.xyz --length-units nm --dump-forces forces.xyz --dump-forces-fmt %24.16e
本例用RESTRAINT ARG=m.xi AT=0.5 KAPPA=2演示偏置连接,实际原子力保存在forces.xyz和力CSV中。被打印的能量、高度标签不会因此自动成为额外偏置。
7 换成自己的属性#
先准备可靠且原子顺序一致的参考结构,再为每幅参考写入完整标签;修改PROPERTY列表、输出名和单位说明。对周期体系先处理坐标连续性和对齐选区,不能用参考标签掩盖原子映像跳变。
下载包的读图脚本针对三参考、六帧和六组设置,换体系时需要调整。命令定义见官方PROPERTYMAP说明。