PLUMED二维伞形文件:不规则中心、方向宽度与半伞实操
使用ECV_UMBRELLAS_FILE从表格定义二维伞形目标,实际运行完整与逐坐标半伞模型,给出输入、STATE读取和偏置力数据图。
阅读本篇目录
下载完整输入、真实轨迹、STATE、三份CSV与绘图脚本。当伞形中心不在规则直线上,或者每个中心、每个方向需要不同宽度,可用ECV_UMBRELLAS_FILE逐行定义。
本例在鸢算科技集群实际运行PLUMED 2.10.1的四条二维解析模型轨迹:完整伞与LOWER_HALF_ONLY各两个种子,每条20000步、dt=0.005、总时间100个自然时间单位。模型势为U=4(x²−1)²+0.5y²;自然温度为1,不是原子材料,也不报告收敛自由能。
1. 先读取配套结果#
unzip plumed-umbrella-file-wave1165-*.zip
cd plumed-umbrella-file
bash read.sh
bash plot.sh
ls analysis figures
读取和画图使用已有输出,不重新跑MD。

图中的椭圆只示意x、y宽度,既不是硬边界,也不是LOWER_HALF_ONLY的截断轮廓。粒子可以离开椭圆区域。
2. 把目标中心与宽度写进文件#
inputs/full-116501/Umbrellas.data完整内容:
#! FIELDS time d.x d.y sigma_d.x sigma_d.y
1 -1 0 0.4 0.8
2 0 0.5 0.6 0.4
3 1 -0.25 0.5 0.7
一行是一个伞形目标;三个中心不共线,x、y方向宽度也不同。首列必须命名为time,这里1、2、3仅为占位标识,不控制MD在哪个时刻启用目标。
后面的列名与PLUMED输入ARG=d.x,d.y对应;宽度列采用sigma_加参数名,即sigma_d.x和sigma_d.y。不要将中心数、每行维数和采样步数混淆。
3. 完整PLUMED输入#
inputs/full-116501/plumed.dat:
UNITS NATURAL
d: DISTANCE ATOMS=1,2 COMPONENTS NOPBC
u: CUSTOM ARG=d.x,d.y VAR=x,y FUNC=4*(x*x-1)^2+0.5*y*y PERIODIC=NO
physical: BIASVALUE ARG=u
ecv: ECV_UMBRELLAS_FILE ARG=d.x,d.y TEMP=1 FILE=Umbrellas.data ADD_P0
b: OPES_EXPANDED ARG=ecv.* PACE=50 OBSERVATION_STEPS=1 PRINT_STRIDE=1 STATE_WFILE=STATE STATE_WSTRIDE=20000
PRINT ARG=d.x,d.y,u,b.bias STRIDE=10 FILE=COLVAR FMT=%24.16e
每个伞形目标i的无量纲能量差为:
Δui(x,y) = (x−xi)²/(2σxi²) + (y−yi)²/(2σyi²)
ADD_P0加入无偏目标,因此三个文件目标加一个P0,共四个目标。physical使双阱物理势参与动力学;b.bias是额外OPES偏置,二者分开记录。
input.dat:
temperature 1
friction 1
tstep 0.005
dimension 2
nstep 20000
ipos -1 0
periodic false
idum 116501
第二个种子为116502。COLVAR每10步记录,包含初始时刻共2001条;DELTAFS每次OPES更新记录一次,含初始记录共401条。
4. LOWER_HALF_ONLY究竟改变什么#
半伞目录保持表格与其他输入不变,只将ECV行改为:
ecv: ECV_UMBRELLAS_FILE ARG=d.x,d.y TEMP=1 FILE=Umbrellas.data ADD_P0 LOWER_HALF_ONLY
它对每一个坐标方向分别处理:
qx = min((x−xi)/σxi, 0)
qy = min((y−yi)/σyi, 0)
Δui = (qx²+qy²)/2
例如相对第一个中心(−1,0),若x=−0.6、y=−0.7,x已高于中心,因此x方向贡献为0;y低于中心,y方向仍有贡献。不是按二维距离截成半圆,也不是只要任一坐标超过中心就将整个伞形设为0。
选择完整伞还是半伞应取决于目标分布设计,不能仅因为某条短轨迹移动更远就断言更合适。
5. 生成新输入并提交#
bash prepare.sh
sbatch job.slurm
squeue -u "$USER"
prepare.sh创建work-new/,不覆盖原目录、不提交。CPU模板为1任务、1CPU、4G,先核对账号可用分区。一次Slurm分配内依次执行四条模型MD及后续STATE探针;不要在登录节点直接跑主计算。
完成后:
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
head -5 analysis-new/PLUMED-umbrella-file-frozen-state.csv
模型MD在各自工作目录实际调用:
plumed pesmd < input.dat > native.log 2>&1
资料包脚本已经设置PLUMED和依赖库路径;Python读取画图采用ASE 3.29.0环境。PLUMED依赖oneAPI 2024.2 / Intel MPI 2021.13。
6. 用固定STATE检查偏置能量与力#
四条实际MD分别保存自己的STATE,然后各选八个二维坐标读取偏置。探针输入使用:
b: OPES_EXPANDED ARG=ecv.* PACE=50 OBSERVATION_STEPS=1 PRINT_STRIDE=1 RESTART=YES STATE_RFILE=STATE FILE=probe-DELTAFS UPDATE_UNTIL=0
探针保留d、u、ECV和PRINT,但移除physical: BIASVALUE ARG=u,所以forces.xyz只返回OPES偏置力;不能把它当成模型总力。
在探针目录中:
plumed driver --plumed plumed.dat --ixyz trajectory.xyz --dump-forces forces.xyz --dump-forces-fmt %24.16e > native.log 2>&1
head -8 COLVAR
head -8 forces.xyz
新计算脚本自动复制各自STATE和相同的Umbrellas.data,再运行这些探针。STATE读取前后的文件内容保持一致,不继续在线学习。

独立读取器用四个目标的ΔF、伞形表达式及其导数求偏置与力,并用能量差分核对。CSV中同时保留原生、独立公式和差分数据,不只是给出一条画好的曲线。
7. 继续使用时保留哪些文件#
cat reference-results/full-116501/STATE
cat reference-results/full-116501/Umbrellas.data
head -6 reference-results/full-116501/DELTAFS
STATE保存OPES估计,但目标标签并不完整编码所有宽度信息。读取时应保留原来的中心、宽度、参数顺序和伞形文件,不能换一张宽度表就默认与旧STATE兼容。完整MD续算还需要底层动力学状态;本例只演示偏置STATE读取。
相关教程:直线伞形与自定义ECV、多温度扩展采样。官方参考:ECV_UMBRELLAS_FILE。