PLUMED专题

PLUMED网格插值:四种查询方式与网格加密

实际比较spline、linear、floor、ceiling,演示GRID_BIN、GRID_SPACING与MIDPOINTS,提供完整终端流程、网格数据和导数图片。

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

已有函数网格,想在非网格点查询数值,或把网格画得更细,可以使用PLUMED的网格查询与插值工具。先区分两种操作:查询是在指定坐标上取值,加密是生成一份节点更多的网格。加密不会凭空增加原始采样的物理信息。

下载完整输入、实际查询结果、四份导出网格及绘图脚本。本例使用集群 PLUMED2.10.1 和Intel oneAPI2024.2运行环境,处理12帧单原子构造坐标,不运行MD或电子结构计算。

1. 下载后怎么操作#

unzip plumed-grid-interpolation-wave1193-*.zip
cd plumed-grid-interpolation
bash read.sh
bash plot.sh
ls analysis figures

先读取已有的实际结果。重新运行:

bash prepare.sh
cat work-new/plumed.dat
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new

prepare.sh创建新目录,不覆盖已有work-new。run.sh加载既有运行库,并调用PLUMED driver。结果中的COLVAR是每帧坐标与四种查询值;coarse.grid、fine.grid、spacing.grid、middle.grid是导出的网格。

2. 完整输入#

UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
f: REFERENCE_GRID FUNC=30+x^3-2*x VAR=x GRID_MIN=-3 GRID_MAX=3 GRID_BIN=12 PERIODIC=NO
p: POSITION ATOM=1 NOPBC
sp: EVALUATE_FUNCTION_FROM_GRID GRID=f ARG=p.x INTERPOLATION_TYPE=spline ZERO_OUTSIDE_GRID_RANGE
li: EVALUATE_FUNCTION_FROM_GRID GRID=f ARG=p.x INTERPOLATION_TYPE=linear ZERO_OUTSIDE_GRID_RANGE
fl: EVALUATE_FUNCTION_FROM_GRID GRID=f ARG=p.x INTERPOLATION_TYPE=floor ZERO_OUTSIDE_GRID_RANGE
ce: EVALUATE_FUNCTION_FROM_GRID GRID=f ARG=p.x INTERPOLATION_TYPE=ceiling ZERO_OUTSIDE_GRID_RANGE
fine: INTERPOLATE_GRID ARG=f GRID_BIN=60 INTERPOLATION_TYPE=spline
spacing: INTERPOLATE_GRID ARG=f GRID_BIN=60 GRID_SPACING=0.1 INTERPOLATION_TYPE=spline
middle: INTERPOLATE_GRID ARG=f MIDPOINTS INTERPOLATION_TYPE=spline
PRINT ARG=p.x,sp,li,fl,ce FILE=COLVAR FMT=%24.16e STRIDE=1
DUMPGRID GRID=f FILE=coarse.grid STRIDE=0 FMT=%24.16e
DUMPGRID GRID=fine FILE=fine.grid STRIDE=0 FMT=%24.16e
DUMPGRID GRID=spacing FILE=spacing.grid STRIDE=0 FMT=%24.16e
DUMPGRID GRID=middle FILE=middle.grid STRIDE=0 FMT=%24.16e

源函数为f=30+x³−2x,x按本例坐标数值以nm计,f是无量纲数学函数。区间−3至3,GRID_BIN=12对应12个区间、13个节点,间距0.5。这个已知函数便于比较操作,不是材料势能面或自由能面。

f: REFERENCE_GRID FUNC=30+x^3-2*x VAR=x GRID_MIN=-3 GRID_MAX=3 GRID_BIN=12 PERIODIC=NO

FUNC在指定节点计算函数及导数;VAR=x指定表达式变量。若读取自己的已有网格,可改为文件入口,格式见网格读取教程。

3. 四种查询方式的区别#

sp: EVALUATE_FUNCTION_FROM_GRID GRID=f ARG=p.x INTERPOLATION_TYPE=spline ZERO_OUTSIDE_GRID_RANGE

把spline依次换成linear、floor、ceiling,即可比较本例四种方式:

方式 本例如何取值
spline 使用网格函数值和导数进行样条查询
linear 相邻节点之间线性插值
floor 取所在区间较低坐标节点的函数值
ceiling 取所在区间较高坐标节点的函数值

四种方式的实际查询与误差

例如查询x=0.2 nm时,左右节点为0和0.5,函数值分别为30和29.125。实际输出:

spline  = 29.608
linear  = 29.650
floor   = 30.000
ceiling = 29.125

样条对这个已知三次函数给出解析值;这依赖于本例函数与准确节点导数,不能推广成“任意稀疏网格都能被精确恢复”。floor与ceiling按坐标选节点,不是按函数值选较小或较大值,也不是自动选择最近节点。

额外两帧查询x=−3.2和+3.2 nm,超出网格范围;因显式设置ZERO_OUTSIDE_GRID_RANGE,四种方法均返回0。这是本例选择的范围外规则,不代表原函数在范围外本身为0。

4. 把网格加密#

fine: INTERPOLATE_GRID ARG=f GRID_BIN=60 INTERPOLATION_TYPE=spline
DUMPGRID GRID=fine FILE=fine.grid STRIDE=0 FMT=%24.16e

原区间仍为−3至3,60个区间对应61个节点,间距0.1。附件还实际运行了同时指定区间数与间距的写法:

spacing: INTERPOLATE_GRID ARG=f GRID_BIN=60 GRID_SPACING=0.1 INTERPOLATION_TYPE=spline

这两份输出的坐标、函数值与导数一致。在当前集群环境中,建议明确写GRID_BIN;若同时提供GRID_SPACING,两者应匹配。本例6/60=0.1。

实际导出节点和网格导数

输出的导数与df/dx=3x²−2一致。图中导数是网格函数对坐标的导数;本例没有施加原子偏置,也没有计算原子偏置力。

5. MIDPOINTS生成什么#

middle: INTERPOLATE_GRID ARG=f MIDPOINTS INTERPOLATION_TYPE=spline
DUMPGRID GRID=middle FILE=middle.grid STRIDE=0 FMT=%24.16e

本例的输出为12个区间中点:

−2.75  −2.25  −1.75  −1.25  −0.75  −0.25
+0.25  +0.75  +1.25  +1.75  +2.25  +2.75

它不包含原端点−3和3,也不是61点加密结果。操作完成后可直接检查:

head -n 8 work-new/middle.grid
head -n 8 work-new/fine.grid
head analysis-new/PLUMED-grid-resampling.csv

网格文件同时包含坐标、函数值与导数。CSV还列出独立解析值,便于检查列与单位是否对应。

6. 手工运行与实际体系使用#

通常直接使用附件run.sh。手工运行一个准备好的目录:

module load oneapi/2024.2
export PLUMED_PREFIX=/public/software/cp2k/deps/2026.2/8173m/plumed-2.10.1
export PLUMED_ROOT="$PLUMED_PREFIX/lib/plumed"
export PLUMED_KERNEL="$PLUMED_PREFIX/lib/libplumedKernel.so"
export LD_LIBRARY_PATH="$PLUMED_PREFIX/lib:${LD_LIBRARY_PATH:-}"
export OMP_NUM_THREADS=1
cd work-new
"$PLUMED_PREFIX/bin/plumed" driver \
  --plumed plumed.dat --ixyz trajectory.xyz --length-units nm

使用自己的分布或自由能网格时,先检查坐标单位、区间、周期属性和导数,再选择插值方法。不要把floor/ceiling的阶梯取值当作连续光滑势面;需要偏置动力学时,应另外确认相应方法的导数与力传播支持。更细的显示网格也不能替代更充分的采样。

参考:网格查询说明、网格加密说明。

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

查看配图

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

100%查看原图 ↗