PLUMED OPES扩展系综:伞形目标、自定义ECV与STATE读取
实际运行两种ECV写法的四条解析模型轨迹,展示OPES_EXPANDED、ADD_P0、状态保存以及冻结STATE后的偏置能量和原子力读取。
阅读本篇目录
下载完整输入、真实轨迹输出、STATE、三份CSV与绘图脚本。OPES_EXPANDED把多个目标分布组合起来,通过在线更新偏置采样。这里先用简单的二维解析模型学会定义ECV、运行、看输出和保存偏置状态。
本例已在鸢算科技集群实际完成四条pesmd模型动力学:两种ECV写法各两个随机种子,每条20000步、时间步0.005、总时间100个自然时间单位。它不是材料体系,不能把自然时间换算为分子的ps、速率,也不把短轨迹的ΔF估计当成收敛自由能。
1. 先读已有结果#
unzip plumed-OPES-expanded-wave1161-*.zip
cd plumed-OPES-expanded
bash read.sh
bash plot.sh
ls analysis figures
读取已完成数据并重画两张图,不重跑动力学。四条MD和四个固定状态探针分别放在reference-results/的独立目录中。

模型物理势为U(x,y)=4(x²−1)²+0.5y²,势阱位于x=±1,沿x的物理势垒为4。看到跨阱运动只能说明这条短轨迹确实移动过,不能据此证明收敛或比较方法效率。
2. 模型动力学的完整输入#
inputs/umbrella-line-116101-addP0/input.dat:
temperature 1
friction 1
tstep 0.005
dimension 2
nstep 20000
ipos -1 0
periodic false
idum 116101
这是PLUMED原生pesmd的二维随机动力学模型。自然单位下kBT=1,初始坐标(−1,0),摩擦参数1。第二个种子为116102;它们都是真实运行,不是把一条曲线重复保存成多组数据。
3. 直线伞形目标的完整PLUMED输入#
同目录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_LINE ARG=d.x TEMP=1 CV_MIN=-1 CV_MAX=1 SIGMA=0.5 SPACING=1 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
pesmd以两个虚拟点的相对位置表示模型坐标,因此读取d.x、d.y。u定义物理势,physical: BIASVALUE ARG=u让该势参与动力学;b才是额外的OPES偏置,分析时两者需要区分。
ECV_UMBRELLAS_LINE在−1到+1之间布置五个中心:−1、−0.5、0、+0.5、+1。SIGMA=0.5是宽度,SPACING=1使相邻间距为一个SIGMA。每个目标的无量纲伞形项为:
Δui(x) = (x−ci)² / (2σ²)
ADD_P0再加入原来的无偏分布,因此本例共有五个伞形目标加一个P0,共六个目标。本例的另一种自定义写法也明确加入P0,以保持目标集合一致。
4. 这些输出频率是什么意思#
PACE=50:每50个MD步更新偏置估计。OBSERVATION_STEPS=1:采用一个初始化观察点。本例第0步先计算无偏值,随后初始化,后续步即可有偏置;不是先等待50步才开始。PRINT_STRIDE=1:每次更新都向DELTAFS输出估计,单位是PACE次数。STATE_WSTRIDE=20000:按MD步数保存状态;本例保留正式结束时的STATE。PRINT ... STRIDE=10:每10步输出坐标、物理势和偏置;包含初态共2001行。
PACE和PRINT_STRIDE不是同一个计数单位,不要只看数字相同就认为输出周期相同。
5. 如何提交新计算#
bash prepare.sh
sbatch job.slurm
squeue -u "$USER"
准备脚本创建work-new/,不覆盖原目录。默认1任务、1CPU、4G内存,依次执行四条短MD,再用各自的新STATE执行固定状态读取。按账号可用CPU分区修改job.slurm;脚本要求在普通用户的Slurm作业内运行。
完成后:
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
单组原生命令是在对应目录内执行:
"$PLUMED_EXE" pesmd < input.dat > native.log 2>&1
环境由包内environment.sh设置:PLUMED 2.10.1、oneAPI 2024.2、Intel MPI 2021.13,实际1进程1线程。这里没有调用GPU、DFT或材料势。
6. 用自定义ECV表达同一组目标#
保留UNITS、坐标、物理势和末尾OPES/PRINT行,把中间的ecv:行换成:
g0: CUSTOM ARG=d.x FUNC=2*(x-(-1))^2 PERIODIC=NO
g1: CUSTOM ARG=d.x FUNC=2*(x-(-0.5))^2 PERIODIC=NO
g2: CUSTOM ARG=d.x FUNC=2*(x-(0))^2 PERIODIC=NO
g3: CUSTOM ARG=d.x FUNC=2*(x-(0.5))^2 PERIODIC=NO
g4: CUSTOM ARG=d.x FUNC=2*(x-(1))^2 PERIODIC=NO
ecv: ECV_CUSTOM ARG=g0,g1,g2,g3,g4 TEMP=1 DIMENSIONLESS ADD_P0
系数2来自1/(2×0.5²)。DIMENSIONLESS表示输入已经是无量纲Δu,不再乘β。若输入实际为能量ΔU,应按方法要求使用相应温度和单位,不能照抄这个标志。
**当前2.10.1示例的两种写法均显式保留ADD_P0。**配套数据实际比较了相同种子下的初始偏置;不要在复现时只删掉一边的P0。两种写法是本模型的表达方式比较,不是声称所有ECV都可互换。长轨迹也不以逐位相同作为一般要求。
7. 看哪些文件#
head reference-results/umbrella-line-116101-addP0/COLVAR
head reference-results/umbrella-line-116101-addP0/DELTAFS
cat reference-results/umbrella-line-116101-addP0/STATE
cat analysis/PLUMED-OPES-expanded-DeltaFs.csv
COLVAR记录实际坐标、物理势和OPES偏置;DELTAFS记录各目标的在线ΔF估计及rct;STATE保存偏置估计和计数等状态。
ΔF以能量单位输出,本例自然单位kBT=1。不能把一列ΔF随时间的变化直接当作沿x的PMF,也不要把rct随意当作重加权修正因子。
自定义ECV的STATE中可能看到NaN文本:它们出现在目标名称占位列中,用来标识该目标关联的ECV,不是末列实际ΔF数值为NaN。读取时应按文件字段解析,不能对整行强行当纯数字。
8. 保存的偏置状态能否真正读回来#
本例还实际读取每条自身的最终STATE,在x=−1.5、−1、−0.5、0、0.5、1、1.5七个固定点计算偏置与力。探针不推进MD,也不继续更新ΔF。
在inputs/probe-umbrella-line-116101-addP0/plumed.dat中保留相同的ECV定义,移除physical: BIASVALUE ARG=u,把OPES与输出行换为:
b: OPES_EXPANDED ARG=ecv.* PACE=50 OBSERVATION_STEPS=1 RESTART=YES STATE_RFILE=STATE FILE=probe-DELTAFS UPDATE_UNTIL=0
PRINT ARG=d.x,d.y,b.bias FILE=COLVAR FMT=%24.16e STRIDE=1
新计算的run.py会把刚生成的STATE复制给对应探针,不会把下载包里的旧STATE冒充新计算结果。单独读取自己状态时,先在独立探针目录复制它,再执行:
"$PLUMED_EXE" driver --plumed plumed.dat --ixyz trajectory.xyz \
--dump-forces forces.xyz --dump-forces-fmt '%24.16e' > native.log 2>&1
这里的XYZ数值按自然单位模型解释,不能当成真实分子nm坐标。移除物理势的BIASVALUE后,forces.xyz仅给OPES偏置力,不混入双阱势的力。

9. 数据如何独立核对#
六个目标的固定偏置公式为:
V(x) = −log[(1/6) Σ exp(−Δui(x)+ΔFi)]
ΔuP0 = 0
读取脚本使用数值稳定的log-sum-exp计算偏置,并用加权导数与能量差分分别核对原子力。粒子2的x力为负偏置梯度,粒子1反向;四个探针的原生能量和解析力均与独立结果在约10^-15量级一致。
cat analysis/PLUMED-OPES-expanded-frozen-state.csv
cat analysis/PLUMED-OPES-expanded-trajectories.csv
**偏置STATE回读不等于完整动力学续算。**恢复完整轨迹还需要宿主程序的位置、速度和随机数等状态;本篇没有把固定坐标探针描述为连续轨迹重启。
10. 用到真实体系前#
选择有物理意义的CV和目标范围,先确认无偏涨落与宽度、偏置强度、电子结构或力场及时间步,再延长采样和分析收敛。不要仅凭短轨迹跨阱或STATE可以读取就给出真实自由能结论。
方法与参数见OPES_EXPANDED官方说明、直线伞形ECV和自定义ECV。