PLUMED专题

PLUMED VES局域基函数:Gaussian、B样条与小波

用实际网格与导数演示Gaussian、三次B样条和Daubechies小波的输入、函数数量、宽度及使用范围。

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

下载输入、实际输出与绘图程序(ZIP)。局域基函数把不同CV区间分开表示;本篇用同一个[−1,1]区间比较三类函数,重点看宽度、边界与导数,不把这些函数图当作材料自由能。

1 先看实际曲线#

解压进入plumed-VES-basis:

bash read.sh
bash plot.sh

三类局域基函数的实际输出,选择不同位置的函数便于比较

图中每类只展示三个函数;完整数据在reference-results/。Gaussian有长尾,B样条只在有限区间有值,小波则包含正负振荡。三者并不能只凭相似的峰宽互相替代。

2 Gaussian:宽度与函数数量#

完整inputs/BF_GAUSSIANS/plumed.dat:

bf: BF_GAUSSIANS ORDER=6 MINIMUM=-1 MAXIMUM=1 WIDTH=0.3 DEBUG_INFO
VES_OUTPUT_BASISFUNCTIONS BASIS_FUNCTIONS=bf GRID_BINS=2000 FILE_VALUES=values.data FILE_DERIVS=derivs.data FORMAT_VALUES_DERIVS=%24.16e

这里WIDTH=0.3是当前无量纲CV单位下的Gaussian标准差,不是相邻中心间距的0.3倍。本例中心间距为1/3;为照顾区间边缘还包含外侧中心,实际是9个Gaussian加常数项,共10个函数,不能把ORDER=6直接解释成6列。

中心为−4/3、−1、−2/3……4/3;函数形状为exp[−(s−中心)²/(2×0.3²)],峰值为1。这组局域函数不是相互正交的函数集合。

3 三次B样条:有限支撑与幅度#

把第一行换成:

bf: BF_CUBIC_B_SPLINES ORDER=6 MINIMUM=-1 MAXIMUM=1 NORMALIZATION=1 DEBUG_INFO

仍使用第二节相同输出命令。当前例子的中心和间距与Gaussian相同,也是10个函数含常数;NORMALIZATION=1下中心峰值是4,并非1。以u=(s−中心)/(1/3)表示,它在|u|>2时为0;因此只影响中心附近的CV范围。B样条形状与约定见官方文档。

边界附近有一部分支撑落在区间外,不能据裁切后的曲线声称整个集合在有限区间严格正交。

4 Daubechies小波:先用这一组参数#

完整inputs/BF_WAVELETS/plumed.dat:

bf: BF_WAVELETS ORDER=8 TYPE=DAUBECHIES MINIMUM=-1 MAXIMUM=1 NUM_BF=40 MIN_GRID_SIZE=32768 DEBUG_INFO
VES_OUTPUT_BASISFUNCTIONS BASIS_FUNCTIONS=bf GRID_BINS=2000 FILE_VALUES=values.data FILE_DERIVS=derivs.data FORMAT_VALUES_DERIVS=%24.16e

ORDER=8描述小波阶数;NUM_BF=40才是包含常数项在内的基函数总数。小波由内部网格构造并插值;MIN_GRID_SIZE控制内部表格,GRID_BINS控制最后导出曲线的网格,两者作用不同。

本例用函数值的独立差分核对导数,最大归一化差异约0.026%;这里的归一化分母为max(1,全局最大导数绝对值),不是每个零点附近的逐点百分比误差。它适合展示这一组单层小波的形状与导数,不能据此宣称完成多尺度自由能优化。官方小波说明列出阶数、支撑与数量参数之间的约束。

当前2.10.1入口的Symlet8在本例有效正支撑参数下,函数值差分与原生导数仍约有0.8%的尺度偏差。涉及偏置力时,建议先使用本篇给出的Daubechies参数,并对自己的区间再次画图、检查导数;不要只把TYPE替换成SYMLETS就沿用精度结论。资料包controls/保留对应数值,默认重做入口只运行正文采用的Daubechies实例。

5 看日志、数据与后续操作#

head -8 reference-results/BF_GAUSSIANS/values.data
head -8 reference-results/BF_CUBIC_B_SPLINES/derivs.data
grep -A16 'Number of basis functions' reference-results/BF_WAVELETS/native.out
cat analysis/PLUMED-VES-basis-validation.csv

第一列是CV,后面从常数f0开始;导数文件与函数值文件逐列对应。常数项导数为0。非周期网格含两端,共2001行。

局域宽度、数量或区间改变后,先重新生成这些文件,检查相邻函数是否覆盖目标CV范围、边缘是否合理,再用于VES偏置。实际系数优化与目标分布不是由这条输出命令自动完成的;多项式、三角和自定义函数见全局基函数操作。

环境与重新运行#

本例使用集群PLUMED 2.10.1的VES模块;该入口以Intel oneAPI C++ 2024.2、Intel MPI 2021.13、MKL 2024.2顺序库和GSL 2.8编译,使用C++17。它随cp2k/2026.2-8173m模块提供,但这几个例子只调用PLUMED driver,不运行CP2K。

在资料包顶层重新计算全部11类基函数:

sbatch run.slurm

这份CPU提交模板按集群56核整节点规则申请资源,程序实际最多并行4个单线程driver。计算完成后:

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

输入复制到新work-new/,同名目录存在时停止,原始参考输出保留。configuration.xyz只有一帧两个H原子,用来让driver正常执行和退出;图中横轴是基函数的无量纲CV网格,不是H—H距离或分子动力学轨迹。正式材料模拟还需要定义实际CV、偏置、目标分布和优化步骤。

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

查看配图

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

100%查看原图 ↗