PLUMED专题

PLUMED矩阵逐元素处理:拼装、平滑区间与偏置受力

用2×3数值矩阵和四点坐标的2×2距离矩阵,实操BETWEEN_MATRIX、CUSTOM_MATRIX、MATHEVAL_MATRIX、COMBINE_MATRIX、SUM_MATRIX,读取原生数值并画出偏置受力。

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

下载两个已完成的例子、完整输入、原生结果、三张CSV与画图脚本(ZIP)。本篇用CP2K2026.2 CPU环境附带的PLUMED2.10.1独立driver,演示如何把多个数拼成矩阵,再按元素处理、求和,最后连接偏置。

两个例子都在鸢算科技集群实际运行。**这里是构造数值和6帧四点坐标的后处理,没有运行分子动力学,也没有真实分子间相互作用势。**它适合学习矩阵数据的流向与偏置的链式传递。

1 解压后先读取、画图#

进入plumed-matrix-functions目录:

bash read.sh
bash plot.sh
head analysis/PLUMED-matrix-constant.csv
head analysis/PLUMED-matrix-pairs.csv
head analysis/PLUMED-matrix-forces.csv

read.sh只读取包内的已完成结果;plot.sh生成两张图片。脚本分别读取2×3常数矩阵、每帧四个距离,以及每帧四个点的三维坐标和受力。forces表保留原生受力和按独立公式求出的解析受力,便于逐项对照。

2 常数矩阵:逐元素计算不会改变行列#

inputs/constant-values/plumed.dat完整内容:

m: CONSTANT NROWS=2 NCOLS=3 VALUES=-1.4,-0.7,-0.1,0.3,0.8,1.7
g: BETWEEN_MATRIX ARG=m LOWER=-0.5 UPPER=0.5 SMEAR=0.2
c: CUSTOM_MATRIX ARG=m FUNC=x*x+2*x PERIODIC=NO
e: MATHEVAL_MATRIX ARG=m FUNC=x*x+2*x PERIODIC=NO
vm: FLATTEN ARG=m
vg: FLATTEN ARG=g
vc: FLATTEN ARG=c
ve: FLATTEN ARG=e
DUMPVECTOR ARG=vm,vg,vc,ve FILE=matrix-values.dat FMT=%24.16e

NROWS=2 NCOLS=3规定两行三列;六个VALUES依次填入第一行,再填第二行。BETWEEN_MATRIX对每个元素计算落在[-0.5,0.5]附近的平滑区间权重,CUSTOM_MATRIX对每个元素求x*x+2*x。本例MATHEVAL_MATRIX与相同表达式的CUSTOM_MATRIX给出相同结果,可以选择其中一个。

实际2×3矩阵与逐元素输出

例如原始元素-0.1对应权重0.975900左右、表达式值-0.19;1.7对应权重接近0、表达式值6.29。**这里的*是对各个元素计算,不是矩阵乘法。**矩阵乘法、求逆和对角化可继续阅读矩阵工具相关教程。

FLATTEN把矩阵变成向量用于输出。matrix-values.dat的parameter是元素索引:本例0、1、2是第一行,3、4、5是第二行。不要把它当成六个时间点。

3 把四个距离拼成2×2矩阵#

第二组读取四点坐标,计算1–3、1–4、2–3和2–4的距离。第一帧trajectory.xyz:

4
10 10 10
X 0.0 0.0 0.0
X 0.2 0.1 0.0
X 0.2 0.3 0.2
X 1.3 0.5 0.4

坐标单位为nm,第二行是driver读取XYZ时使用的盒子。X表示构造点,并不代表某种真实化学元素。六帧里第3个点的x坐标从0.2增加到1.4 nm,其他点保持不变。距离使用NOPBC,不取最小镜像。

本篇显式拼装矩阵:

d: CONCATENATE MATRIX11=d13 MATRIX12=d23 MATRIX21=d14 MATRIX22=d24

行对应第3、4点,列对应第1、2点,所以矩阵与展开顺序为:

       点1    点2
点3    d13    d23
点4    d14    d24

FLATTEN: d13, d23, d14, d24

本例当前构建未启用adjmat模块,不能直接用DISTANCE_MATRIX。用四个DISTANCE拼装即可完成这个小例子,无需安装软件。

4 平滑、组合、求和,再加偏置#

inputs/force-direct-matrix/plumed.dat完整内容:

UNITS LENGTH=nm TIME=fs ENERGY=kj/mol
d13: DISTANCE ATOMS=1,3 NOPBC
d14: DISTANCE ATOMS=1,4 NOPBC
d23: DISTANCE ATOMS=2,3 NOPBC
d24: DISTANCE ATOMS=2,4 NOPBC
d: CONCATENATE MATRIX11=d13 MATRIX12=d23 MATRIX21=d14 MATRIX22=d24
g: BETWEEN_MATRIX ARG=d LOWER=0.5 UPPER=1.5 SMEAR=0.2
p: COMBINE_MATRIX ARG=d,g COEFFICIENTS=2,-0.5 POWERS=1,1 PERIODIC=NO
s: SUM_MATRIX ARG=p PERIODIC=NO
r: RESTRAINT ARG=s AT=0 KAPPA=0.2
vd: FLATTEN ARG=d
vg: FLATTEN ARG=g
vp: FLATTEN ARG=p
DUMPVECTOR ARG=vd,vg,vp FILE=matrix-values.dat STRIDE=1 PRINT_ONE_FILE FMT=%24.16e
PRINT ARG=s,r.bias FILE=COLVAR STRIDE=1 FMT=%24.16e

各步含义:

  1. d保存四个距离的nm数值。教学组合中,以1 nm作参考长度,按这些数值定义无量纲矩阵D。
  2. g对每个距离计算区间[0.5,1.5] nm的平滑权重G,SMEAR=0.2对应本例宽度0.2 nm。
  3. p按相同位置逐项计算P = 2D - 0.5G;COEFFICIENTS是两项的系数,POWERS=1,1表示都取一次方,未启用系数归一化。
  4. s对P的四个元素求和,得到标量S。
  5. r加谐和偏置U=0.2*S*S/2 = 0.1*S*S kJ/mol。

D与G的组合尺度是本例人为定义的教学量,不能直接把它当成材料或分子的真实势函数。实际设计集体变量时,要先明确各项的参考尺度和物理含义。

第一帧S为5.774756640151,偏置为3.334781425297 kJ/mol;最后一帧S为9.218210248790,偏置为8.497540019089 kJ/mol。COLVAR中的两列分别是这两个量。

5 自己运行后处理#

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依次运行两个很短的driver后处理,不启动动力学积分。环境脚本加载cp2k/2026.2-8173m并指定其中PLUMED2.10.1,构建环境为Intel oneAPI2024.2、Intel MPI2021.13。

如果只想手动运行坐标例子,在准备后选择下列操作,避免同时重复运行run.sh:

source /etc/profile
source environment.sh
cd work-new/force-direct-matrix
plumed driver --plumed plumed.dat --ixyz trajectory.xyz \
  --length-units nm --dump-forces forces.xyz
cat COLVAR
head matrix-values.dat
head forces.xyz

常数矩阵不需要坐标,进入work-new/constant-values后运行:

plumed driver --plumed plumed.dat --noatoms
cat matrix-values.dat

COLVAR时间列的1000 fs间隔是driver给构造帧附加的标记,本例没有据此计算动力学时间、扩散系数或自由能。

6 看偏置是否真正传到了原子#

四点构造坐标、矩阵汇总和实际偏置受力

左图是第3帧的xy投影,原始三维坐标仍保存在CSV中;箭头只按统一比例展示偏置受力。右图比较六帧、四个点、三个方向,共72个原生受力分量与独立链式求导结果,数值一致到约1e-14 kJ/(mol·nm)。四点总受力接近零,也符合这个平移不变偏置的要求。

本例当前版本中,先CONCATENATE ARG=...成向量、再用VSTACK接上述矩阵偏置,曾出现“值和偏置正确,但原子受力为零”的结果。**本篇使用的是上面实际传回受力的CONCATENATE MATRIX11=...写法。**这不表示VSTACK不能用于纯数值整理;其参数实际填入矩阵的列,读取时也应留意行列约定。官方VSTACK实现说明了列的排列方式。

常数矩阵例子只演示逐元素输出,不把全常数链直接接入COMBINE_MATRIX、SUM_MATRIX;这类链在当前构建可能触发内部断言。要学习偏置链,直接使用本篇第二组随坐标变化的输入。相关参数可查阅官方COMBINE实现与SUM_MATRIX说明。

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

查看配图

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

100%查看原图 ↗