PLUMED分布比较:KL_ENTROPY的公式与网格操作
用四组归一化网格实际运行KL_ENTROPY,说明其参考方向、与普通KL及完整Jensen–Shannon散度的关系,提供输入、数据和图片。
阅读本篇目录
比较两个概率分布时,先确认使用的数学定义。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的均值、标准差 |
|---|---|---|
| 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 | 普通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。针对实际采样数据,还需要检查统计不确定度、范围截断及分箱或核密度参数;这四个构造分布不代表某种材料的采样结果。