PLUMED网格插值:四种查询方式与网格加密
实际比较spline、linear、floor、ceiling,演示GRID_BIN、GRID_SPACING与MIDPOINTS,提供完整终端流程、网格数据和导数图片。
阅读本篇目录
已有函数网格,想在非网格点查询数值,或把网格画得更细,可以使用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的阶梯取值当作连续光滑势面;需要偏置动力学时,应另外确认相应方法的导数与力传播支持。更细的显示网格也不能替代更充分的采样。