PLUMED自定义ECV:能量、无量纲量与温度换算
用四条实际动力学比较ECV_CUSTOM的两种输入,解释DIMENSIONLESS、COLVAR分量和DELTAFS单位,并读取固定STATE的偏置力。
阅读本篇目录
自定义扩展系综时,一个容易混淆的问题是:传给ECV_CUSTOM的是能量差,还是已经除过kBT的无量纲量?这篇给出两种写法,在相同随机种子下实际运行并比较。偏置计算还会接触两种单位:指数里的约化能量Δu无量纲,而DELTAFS和STATE中的ΔF保留能量单位。
下载完整输入、四条轨迹、冻结偏置结果与绘图脚本。环境为PLUMED 2.10.1,随cp2k/2026.2-8173m加载依赖:Intel oneAPI C/C++ 2024.2、Intel MPI 2021.13,mpiicpx编译,启用OPES模块;本篇直接运行pesmd和driver,不运行CP2K量化计算。
1. 查看现成结果#
unzip plumed-custom-ECV-wave1169-*.zip
cd plumed-custom-ECV
bash read.sh
bash plot.sh
ls analysis/*.csv figures/*.png
读取和绘图不会重新做动力学。新计算要先准备并提交:
bash prepare.sh
sbatch job.slurm
squeue -u "$USER"
模板用CPU分区1任务、1核心、4G内存;按账号选择可用分区。work-new已存在时不会覆盖。全部完成后:
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
2. 本例究竟在算什么#
本例是二维解析势U=4(x²−1)²+y²/2的自然单位模型,基准kBT=2,目标温度为2、3、4。每种写法各使用两个种子,每条20000步、步长0.005,总时间100自然单位。它用来说明输入、单位和偏置力,不是材料模型或已收敛自由能面。
inputs/energy-116901/input.dat:
temperature 2
friction 1
tstep 0.005
dimension 2
nstep 20000
ipos -1 0
periodic false
idum 116901
不要把自然单位的temperature 2直接理解成某种真实分子体系的2 K。换成真实MD时,要使用对应引擎的单位和温度定义。
3. 默认写法:先提供能量差#
对于基准温度T0=2和目标T=3、4,可以将两个能量差写为:
ΔU1 = (T0/3−1)U = −U/3
ΔU2 = (T0/4−1)U = −U/2
完整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
t1: CUSTOM ARG=u FUNC=1*(-1/3)*x PERIODIC=NO
t2: CUSTOM ARG=u FUNC=1*(-1/2)*x PERIODIC=NO
ecv: ECV_CUSTOM ARG=t1,t2 TEMP=2 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,ecv.* STRIDE=10 FILE=COLVAR FMT=%24.16e
ECV_CUSTOM默认把参数当作能量差,并在内部转换为Δu=ΔU/kBT;这里kBT=2。ADD_P0加入原始分布,所以总共是三个目标状态。physical: BIASVALUE ARG=u为这个解析模型提供物理势和力,b才是增强采样偏置。
在已经分配资源的目录中,单独执行:
source environment.sh
cd work-new/energy-116901
"$PLUMED_EXE" pesmd < input.dat > native.log
cd ../..
整组提交脚本已经运行上述过程,不要对有结果的目录再启动一次。
4. DIMENSIONLESS写法:自己先除以kBT#
把两个输入先除以2:
t1: CUSTOM ARG=u FUNC=0.5*(-1/3)*x PERIODIC=NO
t2: CUSTOM ARG=u FUNC=0.5*(-1/2)*x PERIODIC=NO
ecv: ECV_CUSTOM ARG=t1,t2 TEMP=2 ADD_P0 DIMENSIONLESS
其他行不变,完整文件在inputs/dimensionless-116901/plumed.dat。DIMENSIONLESS告诉程序不要再对这两个参数除一次kBT。不能保留原来的能量数值不变,只添加这个开关。

四条实际动力学表明:每个种子内,正确换算后的两种写法,其坐标、物理势和偏置完全重合到本次输出精度。两种写法是同随机种子的单位对照,不能当成新增独立采样;两个种子也不足以说明自由能收敛。
5. 为什么COLVAR里的分量还差一倍#
head -n 5 work-new/energy-116901/COLVAR
head -n 5 work-new/dimensionless-116901/COLVAR
本例字段顺序是:
time d.x d.y u b.bias ecv.t1 ecv.t2
ecv.t1/t2打印传入的原始参数值。因此能量写法的t1=−U/3与无量纲写法的t1=−U/6仍相差2倍;这不表示内部偏置不同。比较时应将前者再除以kBT,不能逐列不分单位地比较整个COLVAR。

对应CSV:
head analysis/PLUMED-custom-ECV-trajectories.csv
head analysis/PLUMED-custom-ECV-DeltaFs.csv
DELTAFS中的ΔF和rct是能量单位,两种正确写法得到相同结果;不要因为加了DIMENSIONLESS就把ΔF也当无量纲。读取指数时需要使用ΔF/kBT。rct不作为这里的重加权修正项使用。
6. 冻结已有偏置,检查力是否一致#
每条MD结束后,脚本把它自己的STATE复制到对应probe-*目录;不混用另一条轨迹的状态。在探针输入中移除物理势的BIASVALUE行,只保留偏置力,并改为:
b: OPES_EXPANDED ARG=ecv.* PACE=50 OBSERVATION_STEPS=1 PRINT_STRIDE=1 RESTART=YES STATE_RFILE=STATE FILE=probe-DELTAFS UPDATE_UNTIL=0
八个探针坐标来自trajectory.xyz,由driver读取:
source environment.sh
cd work-new/probe-energy-116901
"$PLUMED_EXE" driver --plumed plumed.dat --ixyz trajectory.xyz \
--dump-forces forces.xyz --dump-forces-fmt '%24.16e' > native.log
cd ../..
整组脚本已经执行这一步。这里只读取固定状态、冻结偏置更新,不是完整动力学续算。
偏置V可以从三个约化能量和实际ΔF独立重建:
V = −kBT × log{ Σ exp[−Δu + ΔF/kBT] / 3 }
Δu = (0, −U/6, −U/4)
脚本再计算−∂V/∂x、−∂V/∂y,与真实原子受力及偏置能的坐标差分对照。每个模型点有两个虚拟原子,第一原子固定在原点,图中展示第二原子的偏置力;它不含解析物理势U的力。
cat analysis/PLUMED-custom-ECV-frozen-state.csv
cat work-new/energy-116901/STATE
本版STATE中t1 NaN、NaN t2里的NaN是状态组合的文本标签;要检查的是每行最后一列ΔF是否为有限数,不要将标签误认为数值失效。继续使用STATE时,必须保持ECV定义、标签和单位一致。
真实体系优先选择适合问题的内置ECV;自定义能量差时,先核对单位、目标分布和力的传递,再开展更长采样。选项见ECV_CUSTOM说明,ΔF和偏置定义见OPES_EXPANDED说明。