PLUMED专题

PLUMED分布比较:KL_ENTROPY的公式与网格操作

用四组归一化网格实际运行KL_ENTROPY,说明其参考方向、与普通KL及完整Jensen–Shannon散度的关系,提供输入、数据和图片。

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

比较两个概率分布时,先确认使用的数学定义。PLUMED 2.10.1 的KL_ENTROPY实际计算:

m(x) = [p(x) + q(x)] / 2
输出 = ∫ q(x) ln[q(x)/m(x)] dx

这里ARG提供p,REFERENCE文件提供q。输出不是普通的∫q ln(q/p),也不是已经平均两个方向后的完整Jensen–Shannon散度。本篇用四组网格实际演示,便于在分析自己的分布前先熟悉操作。

下载完整网格、PLUMED输入、实际输出与读取绘图脚本。使用集群PLUMED2.10.1和Intel oneAPI2024.2运行库。网格由归一化高斯分布构造,变量x无量纲;只进行网格读取与积分,没有运行MD,也不把这个信息论量当作材料热力学熵。

1. 下载后先读结果#

unzip plumed-KL-grid-wave1189-*.zip
cd plumed-KL-grid
bash read.sh
bash plot.sh
ls analysis figures

重新运行这个网格后处理例子:

bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new

脚本在新的work-new中分别处理四组输入,不覆盖已有目录。run.sh设置已有的oneAPI和PLUMED运行环境。CSV中同时列出原生结果、对应数学积分、普通KL和完整对称JS,方便区分。

2. 四组输入分布#

实际计算所用的p、q与混合分布

目录 p的均值、标准差 q的均值、标准差
same 0、0.4 0、0.4
shift 0.4、0.4 0、0.4
p-wide 0、0.7 0、0.4
q-wide 0、0.4 0、0.7

网格从−4到4,间隔0.01,共801个节点。每份密度按同样的离散积分归一化;所有值为正。本例图只显示中心区,计算仍使用完整网格。

3. 完整PLUMED输入#

UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
pg: REFERENCE_GRID FILE=p.grid VALUE=density
k: KL_ENTROPY ARG=pg REFERENCE=q.grid VALUE=density
pint: INTEGRATE_GRID ARG=pg PERIODIC=NO
qg: REFERENCE_GRID FILE=q.grid VALUE=density
qint: INTEGRATE_GRID ARG=qg PERIODIC=NO
PRINT ARG=k,pint,qint FILE=COLVAR FMT=%24.16e STRIDE=1

先用REFERENCE_GRID读取p,再将p交给KL_ENTROPY,后者读取q文件。VALUE=density指定网格中的密度列。pint和qint用于检查两个分布的积分是否接近1。

资料包的网格文件格式为:

#! FIELDS x density ddensity_x
#! SET min_x -4
#! SET max_x 4
#! SET nbins_x 800
#! SET periodic_x false

后面每行依次给出x、密度和密度对x的导数。ddensity_x表示d加上列名density及_x,不是拼写错误。本例非周期网格的800个区间对应801个节点。PLUMED当前网格读取入口使用.grid扩展名;不要只换文件名而忽略列名、导数、范围和周期属性。

INTEGRATE_GRID按网格间距求和。本例使用Δx × Σ密度归一化,并按同一规则比较积分;不把别的积分约定直接混入结果。

4. 实际数值怎样解释#

实际KL_ENTROPY、完整JS与普通KL的差别

分布组 原生KL_ENTROPY 完整对称JS 普通D(q∥p),独立对照
same 0 0 0
shift 0.1114214822 0.1114214822 0.5000000000
p-wide 0.0788698030 0.0648242393 0.2228810835
q-wide 0.0507786755 0.0648242393 0.4716338558

对数为自然底,数值无量纲,可记作nat。shift组因对称性,两方向的分量相等,所以原生输出碰巧等于完整JS;这不是一般恒等关系。宽度不同的两组清楚显示,交换p、q会改变单次原生输出。

若需要完整的对称Jensen–Shannon散度,应分别计算两个方向后取平均:

JS(p,q) = [D(p∥m) + D(q∥m)] / 2

本例p-wide与q-wide正好互换输入,所以:

(0.0788698030252 + 0.0507786755355) / 2
= 0.0648242392804

不要把单次KL_ENTROPY值直接填进普通KL公式或完整JS的表格。名称相近不代表输出定义完全相同。

5. 手工运行命令#

可以直接使用资料包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/p-wide
"$PLUMED_PREFIX/bin/plumed" driver \
  --plumed plumed.dat --ixyz trajectory.xyz --length-units nm
cat COLVAR

这里的单原子单帧XYZ只用于驱动网格操作,没有从该原子的坐标估计概率分布,也没有施加原子偏置。

6. 换成自己的分布之前#

先确保p、q使用同一个变量、单位、网格范围、间距和周期定义,密度已归一化,并检查零值或极小值对对数计算的影响。不要把自由能曲线数值直接当作概率密度输入。

本例读取器逐项核对了网格、密度、导数、归一化和实际积分,并独立计算普通KL与对称JS。针对实际采样数据,还需要检查统计不确定度、范围截断及分箱或核密度参数;这四个构造分布不代表某种材料的采样结果。

参考:PLUMED KL_ENTROPY说明、2.10.1实现中的积分公式。

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

查看配图

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

100%查看原图 ↗