PLUMED专题

PLUMED终点判定:COMMITTOR首次进入与NOSTOP

用四条短构造轨迹实跑A/B终点判定,说明严格区间、首次停止、无事件和离开后再次进入,附完整命令、轨迹与事件图。

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

想让模拟在进入指定稳定态后停止,或者记录轨迹何时进入某个区域,可以使用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。

四条构造输入、实际处理的CV以及原生记录的进入事件

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的重复进入同理。

两点几何、严格边界及NOSTOP实际记录;左图各行仅为排版,不改变输入的y=z=0

因此事件数量不是“盆地里有多少帧”,也不直接等于相互独立的反应次数。

7.无事件文件怎么理解#

no-hit的所有帧都在两个开区间以外,因此完整读取5帧,COMMITTED没有数值事件。文件为空或只有头信息是可以预期的结果,应结合COLVAR、轨迹长度和区间判断。

一次未进入任何盆地,不能解释为该初始构型的承诺概率为0;它可能只是观察时间不足,或者终态定义与所用CV不合适。本例明确给出了完整距离序列,因此可以直接判断为何没有事件。

8.真实committor分析的下一步#

真实承诺概率通常需要从选定起始构型出发,以合适的速度分布或随机种子启动多次独立动力学,判断每次先到A还是B,再统计比例及不确定性。起始条件、无事件样本处理、盆地定义和动力学模型都会影响结果。

本篇已经提供终点判定的运行与读取流程;用于真实体系时,应把构造XYZ替换成自己的物理轨迹,或在MD引擎中使用相同Action,并按需要选择默认停止或NOSTOP。单条构造路径本身不提供承诺概率、速率常数或统计收敛结论。

参考:PLUMED 2.10 COMMITTOR说明。

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

查看配图

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

100%查看原图 ↗