PLUMED终点判定:COMMITTOR首次进入与NOSTOP
用四条短构造轨迹实跑A/B终点判定,说明严格区间、首次停止、无事件和离开后再次进入,附完整命令、轨迹与事件图。
阅读本篇目录
想让模拟在进入指定稳定态后停止,或者记录轨迹何时进入某个区域,可以使用COMMITTOR。先定义用哪些集体变量区分终态,再为每个终态指定区间。本篇用两个点的距离d演示A、B两个终点,重点是命令和输出判读。
四个例子在鸢算科技集群以PLUMED 2.10.1独立driver实际运行。输入是明确构造的两点XYZ序列,没有运行MD、随机射击或真实分子的承诺概率统计;每帧时间仅按0.5ps映射,不能据此计算真实反应速率。
1.先读取已完成数据#
下载COMMITTOR终点判定实例包,解压进入plumed-committor:
bash read.sh
bash plot.sh
head analysis/PLUMED-committor-frames.csv
cat analysis/PLUMED-committor-events.csv
| 文件 | 内容 |
|---|---|
analysis/PLUMED-committor-frames.csv |
所有输入帧的距离、独立区间判断、哪些帧实际被driver处理 |
analysis/PLUMED-committor-events.csv |
原生记录的进入时间、距离、盆地编号及对应输入帧 |
figures/PLUMED-committor-firstpassage.png |
四条输入和实际处理范围、进入事件 |
figures/PLUMED-committor-geometry-events.png |
实际两点几何与NOSTOP事件 |
读取和画图不会重新执行driver。

2.运行环境和重算#
实例使用cp2k/2026.2-8173m环境附带的PLUMED 2.10.1独立程序,构建工具链为oneAPI 2024.2、icpx 2024.2.1和Intel MPI 2021.13,单进程单线程。加载此环境只是获得相应依赖,并不会启动CP2K电子结构计算。
bash prepare.sh
bash run.sh
bash read.sh work-new analysis-new
bash plot.sh analysis-new figures-new
prepare.sh创建work-new,已有目录不会覆盖。run.sh加载依赖后顺序运行四个条件。手动只跑一条时,在适当计算资源内执行:
source environment.sh
cd work-new/first-A
"$PLUMED_EXE" driver --plumed plumed.dat --ixyz trajectory.xyz --length-units nm --timestep 0.5
cat COLVAR
cat COMMITTED
--length-units nm说明XYZ坐标以nm输入;--timestep 0.5把连续帧映射为0、0.5、1.0…ps,不会为这些坐标补做动力学。
3.完整PLUMED输入#
inputs/first-A/plumed.dat:
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
d: DISTANCE ATOMS=1,2 NOPBC
PRINT ARG=d STRIDE=1 FILE=COLVAR FMT=%24.16e
COMMITTOR ARG=d STRIDE=1 BASIN_LL1=0.0 BASIN_UL1=0.3 BASIN_LL2=1.7 BASIN_UL2=2.2 FILE=COMMITTED FMT=%24.16e
DISTANCE读取两点距离,PRINT每帧保存到COLVAR。A、B两盆地分别定义为:
| 名称 | 原生编号 | 区间/nm |
|---|---|---|
| A | 1 | 0<d<0.3 |
| B | 2 | 1.7<d<2.2 |
该版本使用严格不等式:d恰好等于0.3或1.7时,不算进入。STRIDE=1表示每帧判断;增大stride会减少检查频率,也可能漏过短暂进入。FILE=COMMITTED保存事件,编号来自BASIN_LL1/UL1、LL2/UL2的顺序。
使用多个CV时,每个盆地的上下界都应提供对应数量的值,且要同时满足各维区间;真实体系应选择能区分所需状态的CV和边界,不能照抄本篇距离区间。
4.两点输入长什么样#
第一帧XYZ:
2
10 10 10
X 0 0 0
X 1 0 0
每帧两个点,第二行给driver盒子,NOPBC使本篇直接用两点距离。X只是构造点标记,不代表真实化学元素;所有实际y=z=0。四条距离序列为:
first-A: 1.0 0.8 0.3 0.2 0.1 1.0 1.9
first-B: 1.0 1.2 1.7 1.8 2.1
no-hit: 0.5 0.3 1.0 1.7 0.6
nostop-reentries: 1.0 0.2 0.25 0.5 0.2 1.8 1.9 1.0 1.8
资料包包含每条完整trajectory.xyz,可以直接运行,无需手工拼帧。
5.默认模式:首次进入就停止#
| 条件 | 输入帧数 | 实际处理帧数 | 首次进入 | 映射时间 |
|---|---|---|---|---|
first-A |
7 | 4 | A,d=0.2nm | 1.5ps |
first-B |
5 | 4 | B,d=1.8nm | 1.5ps |
no-hit |
5 | 5 | 无事件 | — |
first-A的第2号帧(从0计数)d=0.3,恰好是边界,继续运行;下一帧d=0.2才触发A。触发帧仍保存在COLVAR中,后续三帧没有被处理。完整输入中后面即使包含B,也不改变这次“先进入A”的结果。
原生事件文件中的数值行是:
#! FIELDS time d basin
1.500000 0.2 1
后续注释含COMMITTED TO BASIN 1。读取程序忽略注释但保留原生事件值,不把未处理的后续输入当作已计算轨迹。
6.NOSTOP:持续记录进入事件#
把最后一行改为:
COMMITTOR ARG=d STRIDE=1 BASIN_LL1=0.0 BASIN_UL1=0.3 BASIN_LL2=1.7 BASIN_UL2=2.2 FILE=COMMITTED FMT=%24.16e NOSTOP
第四组读完9帧,实际记录:
| 输入帧 | 映射时间/ps | 距离/nm | 进入盆地 |
|---|---|---|---|
| 1 | 0.5 | 0.2 | A |
| 4 | 2.0 | 0.2 | A |
| 5 | 2.5 | 1.8 | B |
| 8 | 4.0 | 1.8 | B |
在同一个盆地连续停留不会每帧记一次。例如第1帧0.2、第2帧0.25都在A,只记录首次进入。第3帧0.5离开后,第4帧0.2重新进入A,才产生第二个A事件;B的重复进入同理。

因此事件数量不是“盆地里有多少帧”,也不直接等于相互独立的反应次数。
7.无事件文件怎么理解#
no-hit的所有帧都在两个开区间以外,因此完整读取5帧,COMMITTED没有数值事件。文件为空或只有头信息是可以预期的结果,应结合COLVAR、轨迹长度和区间判断。
一次未进入任何盆地,不能解释为该初始构型的承诺概率为0;它可能只是观察时间不足,或者终态定义与所用CV不合适。本例明确给出了完整距离序列,因此可以直接判断为何没有事件。
8.真实committor分析的下一步#
真实承诺概率通常需要从选定起始构型出发,以合适的速度分布或随机种子启动多次独立动力学,判断每次先到A还是B,再统计比例及不确定性。起始条件、无事件样本处理、盆地定义和动力学模型都会影响结果。
本篇已经提供终点判定的运行与读取流程;用于真实体系时,应把构造XYZ替换成自己的物理轨迹,或在MD引擎中使用相同Action,并按需要选择默认停止或NOSTOP。单条构造路径本身不提供承诺概率、速率常数或统计收敛结论。