PLUMED扩展拉格朗日:辅助变量、阻尼与叠加偏置
用五组短输入实算EXTENDED_LAGRANGIAN辅助变量响应、质量与阻尼,输出原子偏置力,并演示在辅助变量上再加约束。
阅读本篇目录
普通谐约束给定一个固定中心;EXTENDED_LAGRANGIAN则引入有惯性的辅助变量,让它与真实集体变量通过谐势耦合。本篇从两点距离出发,观察辅助变量如何响应、怎样输出偏置能和原子力,以及如何在辅助变量上再施加偏置。
五组例子在鸢算科技集群以PLUMED 2.10.1独立driver实际运行,每组32帧。两点坐标是明确构造的输入,原子没有进行MD积分;PLUMED内部的辅助变量确实进行了推进。这里没有有限温随机采样、真实材料动力学或TAMD自由能结果。
1.读取真实结果与画图#
下载扩展拉格朗日实例包,解压进入plumed-extended-lagrangian:
bash read.sh
bash plot.sh
head analysis/PLUMED-extended-lagrangian-summary.csv
| 文件 | 内容 |
|---|---|
analysis/PLUMED-extended-lagrangian-frames.csv |
每帧真实CV、辅助坐标、原生速度、耦合及附加偏置能、两点偏置力与独立递推 |
analysis/PLUMED-extended-lagrangian-summary.csv |
TAU、阻尼、辅助质量及本次短输入的响应读数 |
figures/PLUMED-extended-lagrangian-response.png |
恒定、驱动、不同TAU及阻尼响应 |
figures/PLUMED-extended-lagrangian-force-bias.png |
实际两点几何、原子力及辅助变量上的附加偏置 |
读取和画图不会重新执行driver。

2.准备并运行#
使用集群cp2k/2026.2-8173m附带的PLUMED 2.10.1,构建工具链为oneAPI 2024.2、icpx 2024.2.1和Intel MPI 2021.13,单进程单线程。这里调用独立driver,不启动CP2K电子结构。
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
prepare.sh新建work-new且拒绝覆盖。run.sh加载相应依赖,顺序运行五组。手动运行驱动距离例子:
source environment.sh
cd work-new/driven
"$PLUMED_EXE" driver --plumed plumed.dat --ixyz trajectory.xyz --length-units nm --timestep 0.01 --dump-forces forces.xyz --dump-forces-fmt %24.16e
head COLVAR
head forces.xyz
本例每帧按0.01ps映射时间,原生输出0至0.31ps。这个映射同时作为内部辅助变量的推进步长,但不会把输入坐标自动变成经过相互作用势积分的原子MD轨迹。
3.完整基础输入#
inputs/driven/plumed.dat:
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
d: DISTANCE ATOMS=1,2 NOPBC
ex: EXTENDED_LAGRANGIAN ARG=d KAPPA=100 TAU=0.4 FRICTION=0.0 TEMP=0
PRINT ARG=d,ex.d_fict,ex.d_vfict,ex.bias FILE=COLVAR STRIDE=1 FMT=%24.16e
第一帧XYZ为:
2
10 10 10
X 0 0 0
X 0.5 0 0
真实CV是两点距离。驱动组输入距离按下面的明确公式构造:
d[n] = 0.5 + 0.05*sin(2*pi*n/16) nm
n = 0, 1, ... , 31
所有点的y=z=0,NOPBC不取最小镜像。X只是构造点的标记,没有指定真实分子力场。
4.KAPPA与TAU控制什么#
设真实距离为d,辅助变量为s,则耦合势能:
Vcouple = 0.5 * KAPPA * (d-s)^2
maux = KAPPA * (TAU/(2*pi))^2
KAPPA为耦合刚度;距离型CV使用本例单位时是kJ·mol⁻¹·nm⁻²。TAU以ps计,通过上式决定辅助质量,不能把它当成原子质量或只看作输出间隔。
本例KAPPA=100、TAU=0.4ps,辅助质量约0.4052847346;TAU改成0.8ps,质量变为1.6211389383,即四倍。辅助变量起始位置等于首帧真实CV,初始速度为零。
| 输出列 | 含义 |
|---|---|
d |
真实输入距离 |
ex.d_fict |
辅助坐标 |
ex.d_vfict |
该版本保存的上一步更新速度 |
ex.bias |
谐耦合势能 |
extra.bias |
本篇附加约束的势能,仅第五组存在 |
**ex.bias不是“耦合势能加辅助动能”的总和。**计算辅助动能时还要使用相应质量并理解速度的时间位置;ex.d_vfict不是同一帧辅助坐标做简单差分就必然相同的量。
5.五组实际条件#
| 目录 | 距离输入 | TAU/ps | FRICTION/ps⁻¹ | 额外辅助约束 |
|---|---|---|---|---|
constant |
恒为0.5nm | 0.4 | 0 | 无 |
driven |
正弦驱动 | 0.4 | 0 | 无 |
longer-tau |
相同正弦驱动 | 0.8 | 0 | 无 |
damped |
相同正弦驱动 | 0.4 | 4 | 无 |
biased-auxiliary |
恒为0.5nm | 0.4 | 0 | 对辅助变量施加中心0.6nm、刚度10的约束 |
恒定组中辅助变量始终为0.5nm,速度、耦合能和原子偏置力均为零。正弦驱动组中,辅助变量有独立的响应,并不严格贴着真实距离移动。
| 条件 | 最后一帧辅助值/nm | 本次最大距离差/nm | 最大耦合势能/(kJ/mol) |
|---|---|---|---|
driven |
0.480376878 | 0.082133930 | 0.337299123 |
longer-tau |
0.507489799 | 0.060442518 | 0.182664902 |
damped |
0.490052845 | 0.077017594 | 0.296585487 |
biased-auxiliary |
0.504854243 | 0.018187442 | 0.016539153 |
这些最大值取决于给定驱动与有限观察窗口。不能由这一次表格推断“TAU越大,任意任务的最大距离差一定越大或越小”;应结合时间尺度和实际采样目标选择参数。
6.阻尼示例为什么设TEMP=0#
ex: EXTENDED_LAGRANGIAN ARG=d KAPPA=100 TAU=0.4 FRICTION=4 TEMP=0
非零FRICTION引入阻尼;本篇TEMP=0使随机热噪声项为零,便于单独观察确定性阻尼。在相同距离输入下,damped与无阻尼组响应不同。
真正的高温辅助变量采样需要合理温度、时间尺度分离及足够统计,本例不据TEMP=0测试推断有限温Langevin采样或TAMD收敛。迁移到真实MD引擎时,也应核对温度来源和单位。
7.在辅助变量上再加偏置#
第五组完整输入:
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
d: DISTANCE ATOMS=1,2 NOPBC
ex: EXTENDED_LAGRANGIAN ARG=d KAPPA=100 TAU=0.4 FRICTION=0.0 TEMP=0
extra: RESTRAINT ARG=ex.d_fict AT=0.6 KAPPA=10
PRINT ARG=d,ex.d_fict,ex.d_vfict,ex.bias,extra.bias FILE=COLVAR STRIDE=1 FMT=%24.16e
RESTRAINT ARG=ex.d_fict施加在辅助变量上,中心为0.6nm。即使真实距离输入固定0.5nm,辅助变量也会在该偏置与原有耦合之间响应,进而通过耦合产生原子偏置力。辅助变量不是第三个原子,不应把它直接当成新的原子坐标或已有原子的受力。

两点沿x排列时,第二点的耦合力为:
Fx(point2) = -KAPPA * (d-s)
Fx(point1) = -Fx(point2)
原生forces.xyz保存这两个偏置力,不包含未定义的真实分子间势。第五组应同时读取ex.bias和extra.bias,而不是把其中一个字段解释为所有偏置的总量。
8.用于自己的CV时#
把距离替换为适合体系的真实CV,分别选择其KAPPA、TAU和必要的阻尼/温度。多个CV可给相应参数列表,但必须注意每个CV的量纲和周期性。需要在辅助变量上继续加偏置时,引用对应的_fict组件;不能对_vfict速度组件按同样方式施加偏置。
本篇版本的EXTENDED_LAGRANGIAN重新启动时会重新初始化辅助坐标与速度,不能把多段独立启动直接声称为严格等价的一次连续运行。生产任务应按方法与版本明确续算策略,保留需要的状态与输出。
本篇展示命令、数据、偏置力及确定性辅助变量推进;自由能估计、真实体系平衡和采样误差还需要相应的物理计算与统计。