PLUMED专题

PLUMED自定义ECV:能量、无量纲量与温度换算

用四条实际动力学比较ECV_CUSTOM的两种输入,解释DIMENSIONLESS、COLVAR分量和DELTAFS单位,并读取固定STATE的偏置力。

更新于 2026-11-16约 6 分钟阅读按任务与环境选择适用配置
阅读本篇目录

自定义扩展系综时,一个容易混淆的问题是:传给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。

原始ECV分量及实际冻结STATE的八点偏置力

对应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说明。

需要根据你的体系选择资源?联系讨论计算需求。实际可用软件与权限,以当前账户和运行环境为准。

查看配图

放大后可滚动查看细节,按 Esc 关闭。

100%查看原图 ↗