PLUMED专题

PLUMED最大熵约束MAXENT实操

用三组真实driver回放学习距离约束、动态Lagrange乘子、Gaussian误差先验,以及偏置能量和原子受力的读取。

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

MAXENT根据观测量与目标值的偏离,逐步更新Lagrange乘子,形成随时间变化的线性偏置。它与固定弹簧常数的谐波约束不同:约束系数会学习,不能只看某一帧距离就判断目标平均值是否已经满足。

本篇使用10帧明确给定的两原子几何,做三组PLUMED driver实际回放,展示更新与受力。距离目标0.75nm是教学设定,不是实验测量数据;本例没有MD采样,也没有证明最大熵系综已经收敛。

1.先读结果、画图#

下载完整输入、原生输出、CSV和画图脚本,保存为example.zip:

python3 -m zipfile -e example.zip .
cd plumed-MAXENT
bash read.sh
bash plot.sh
cat analysis/PLUMED-MAXENT.csv

三组分别是pure、gaussian、double-kBT。脚本逐帧提取乘子、偏置、原子受力和实际几何残差,图片输出到figures。

2.完整plumed.dat#

UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
d: DISTANCE ATOMS=1,2 NOPBC
m: MAXENT ARG=d TYPE=EQUAL AT=0.75 KAPPA=0.2 TAU=5 PACE=1 PRINT_STRIDE=1 SIGMA=0 ERROR_TYPE=GAUSSIAN FMT=%24.16e
PRINT ARG=d,m.bias,m.force2,m.d_coupling,m.d_error,m.work STRIDE=1 FILE=COLVAR FMT=%24.16e

TYPE=EQUAL选择等式约束,AT给目标,KAPPA控制初始更新系数,TAU控制学习率随时间减弱,PACE控制更新间隔。SIGMA=0不引入观测误差先验;本篇第二组仅将SIGMA改为0.3,使用Gaussian先验作对照。

这些参数不是“距离偏离多少就施加固定弹簧力”的设置。正式应用需要按观测量单位、采样间隔和收敛行为选择参数,不能把本例的数值当成通用推荐。

轨迹的首帧如下,XYZ坐标按nm读取:

2
frame 0
H 0 0 0
H 0.8 0 0

完整10帧的距离依次为0.8、1.0、0.6、0.9、0.7、0.85、0.65、0.95、0.75、0.8nm,文件已随包提供。

3.准备同版本的个人程序#

本例使用PLUMED2.10.1、GNU13.3构建的单进程程序,OMP=1。它复用RDF教程中相同版本的个人环境,集群公共默认模块保持原版本。

如果已经有对应的个人PLUMED前缀:

bash prepare.sh
bash run.sh /自己的路径/local-plumed

如果没有,可在自己的编译资源中创建资料包局部环境:

bash setup.sh
bash prepare.sh
bash run.sh

setup.sh下载并核对固定上游源码,再安装到当前目录的local-plumed;不修改公共软件。已有同名安装或工作目录时会保留并停止,避免覆盖。

重新计算后读取:

bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new

这一组回放只是偏置后处理。把MAXENT接入真正MD时,应使用与引擎链接版本匹配的输入和资源模板,并让引擎实际积分;不能把离线回放解释成MD轨迹。

4.driver的关键终端命令#

在work-new/pure中,核心命令为:

plumed driver --plumed plumed.dat \
  --ixyz trajectory.xyz --length-units nm \
  --box 3,3,3 --timestep 1 --kt 2.5 \
  --dump-forces forces.xyz

资料包的run.sh自动选择个人程序并设置内核路径,可以直接使用。--timestep 1使相邻帧对应1ps;--kt 2.5给的是能量单位的kBT,即2.5kJ/mol,不是2.5K。第三组把它改成5,其余几何与学习参数保持不变。

5.乘子、偏置和力怎样对应#

本例每一帧先用当前乘子计算并输出,再更新下一帧的乘子。初始乘子为0,因此第一帧偏置与力都为0;不能把第一帧没有受力当成MAXENT没有工作。

固定同一时刻的乘子λ,线性偏置为V = kBT*λ*d。本例原子连线沿x方向,两个原子所受偏置力分别为+kBT*λ和−kBT*λ。

情况 时间/ps 当前乘子 偏置/kJ·mol⁻¹
pure 0 0 0
pure 1 0.0100000000 0.0250000000
pure 9 0.0610082973 0.1220165945
gaussian 9 0.0578714687 0.1157429375
double-kBT 9 0.0610082973 0.2440331890

MAXENT预设几何、动态乘子和偏置对照

第三组kBT加倍后,偏置与原子力加倍,m.force2变成4倍,而乘子序列保持不变。这里的m.force2是对CV的偏置力平方,不是把两个原子的力平方都加起来。

本次固定版本的实际递推由配套read.py逐帧计算:

rate = kappa / (1 + time_ps / tau_ps)
lambda_next = lambda_now + rate * (
    distance - target - sigma**2 * lambda_now
)

这是本例TYPE=EQUAL、Gaussian先验、非REWEIGHT路径、PACE=1的实际实现。其他约束类型、重加权路径或多副本设置不能直接沿用这个简式。官方总览式的符号与该版本实现存在差异,比较数值时应同时核对版本、λ定义和实际偏置受力方向,不能从概述公式直接抄一段更新代码。

6.哪些输出容易读错#

m.d_coupling是当前乘子,m.LAGMULT是相应的独立输出文件,可以与COLVAR逐帧对照:

head reference-results/pure/COLVAR
head reference-results/pure/m.LAGMULT
head reference-results/pure/forces.xyz

本例使用的2.10.1实现中,m.d_error保持初始化的0,不能把它当作实际的d−AT残差。资料包CSV单独计算geometric_residual_nm;例如第一帧残差为+0.05nm,虽然原生m.d_error仍为0。

该实现的m.work是未乘kBT的乘子更新累计项,也不要直接把这一列标成kJ/mol机械功。本篇保留原始输出,并用明确列名区分它与偏置能量。

read.py独立核对乘子递推、偏置、CV力平方、两原子受力及净力,再比较Gaussian先验与kBT缩放。正式用于实验约束时,还需要检查观测量定义、误差模型、统计平均与采样收敛,而不是只确认产生了COLVAR。

参数、其他约束类型和多副本选项见PLUMED官方MAXENT说明。

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

查看配图

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

100%查看原图 ↗