software

PLUMED 实跑,同一条链的端到端距离为什么从 1.2 变成 0.8?

作者:发布于 2026-11-17约 11 分钟阅读
同一条链,距离为何不同?。六组后处理实跑|先核对周期几何与单位,再解释偏置。。周期边界,最近映像 0.8 nm,完整链 1.2 nm,重建坐标后,距离计算仍需选择合适的周期规则。。变量定义,只重建两个末端,偏置能量变成 0,命令成功不代表它测到了所需的端到端距离。。单位,正确换算为 8,错误设置约 6272,单位均为 kJ/mol;分别检查输入、内部单位和参数。。

准备增强采样时,很多人先选择偏置强度,再观察集体变量有没有离开初始位置。但如果集体变量本身读错了坐标,增加模拟时间只会继续围绕错误的量施加作用。本文安装并运行 PLUMED,用一条人为构造的四点链检查端到端距离,实际比较周期边界、分子重建、长度单位和谐和约束能量。四个点的位置关系非常简单,可以用手算核对每一项输出。

本次运行的是 PLUMED 的轨迹后处理工具,输入包含三帧自建坐标。没有连接分子动力学引擎,也没有推进粒子运动,更没有由三帧数据估计自由能。我们要验证的是,在进入真正的采样之前,程序计算的距离、时间和偏置能量是否符合原先的定义。这类短检查适合放在复杂蛋白或聚合物计算的准备阶段。

先把几何关系写出来

设一个边长为二纳米的立方周期盒,四个点沿横向依次排列,相邻间距均为零点四纳米。第一帧的横向坐标为零点一、零点五、零点九和一点三纳米,纵向与深度坐标相同。因此,沿着这条完整链,从第一个点到第四个点的直线距离是一点二纳米。它已经超过盒长的一半,这是后面出现不同答案的关键。

接下来的两帧只做整体平移,分别把所有横向位置增加零点八和一点二纳米,再把坐标折回零到二纳米的主盒。点之间的实际连接顺序和间隔没有改变,但文件中的坐标会跨过边界。例如第二帧的坐标为零点九、一点三、一点七和零点一,最后一个点看起来跑到了最左边。如果直接把这份文件当成一条没有周期边界的直链,就会误读它的几何关系。

这里的“链”只是用于检验的几何对象,输入没有真实化学键参数,也不代表某种实验分子。它的优点是每一对相邻点都在半盒范围以内,重建时存在清楚的逐点路径。真实体系中,需要从拓扑、原子选择和盒子信息确认对应条件,而不是根据文件中原子编号连续就认定它们在空间上相邻。

三种距离分别回答什么问题

首先直接忽略周期性,使用文件中两个端点的坐标计算距离。第一帧得到一点二纳米,后两帧却得到零点八纳米。这种变化不是链突然缩短,而是同一几何对象被写成了不同的周期映像。忽略周期边界只改变距离计算方式,并不会自动把跨界的分子接回去。

其次使用默认的周期距离。它寻找两点之间较近的周期映像,因此三帧都得到零点八纳米。这是一个稳定的输出,却仍不等于本例希望测量的完整链端到端距离。稳定只能说明数值没有随当前写法跳动,不能单独证明变量定义符合研究问题。DISTANCE 官方说明

第三种方法是先沿着链重建坐标,再忽略周期边界计算两端距离。三帧都得到一点二纳米,才与本例定义一致。对其他研究问题,周期最近映像距离可能恰好是所需的量。因此,选择哪一种计算方式应先由问题决定,不能给所有距离统一添加或删除忽略周期边界的选项。

三帧中的距离 第 1 帧 第 2、3 帧
原始坐标直接相减 1.2 nm 0.8 nm
默认周期距离 0.8 nm 0.8 nm
完整链重建后计算 1.2 nm 1.2 nm

重建命令要放在变量之前,原子列表也要连得起来

本次使用 WHOLEMOLECULES 重建这条链。它按给出的实体列表处理坐标,沿相邻条目选择接近的周期映像。重建完成后,位于其后面的距离计算才能使用已经调整的坐标。以下输入故意保留重建前后的多个变量,便于对照,而不是只打印最终想要的一个数字。

raw: DISTANCE ATOMS=1,4 NOPBC
mic: DISTANCE ATOMS=1,4
WHOLEMOLECULES ENTITY0=1-4
whole: DISTANCE ATOMS=1,4 NOPBC
aftermic: DISTANCE ATOMS=1,4
PRINT ARG=raw,mic,whole,aftermic STRIDE=100 FILE=COLVAR

实测中,即便完成重建,最后那项仍使用周期距离的变量也保持零点八纳米。原因很直接,重新拼接坐标并不会让距离命令忘记自己的周期计算规则。需要完整链端到端距离时,重建和随后忽略周期性必须配合使用。反过来,如果先算距离再重建,先前计算的变量也不会自动变成你希望的新定义。重建顺序与原子列表要求

我们还实际运行了一个容易犯错的列表,只把两个端点放进重建命令,省掉中间两个点。这时两端之间本来就超过半盒,按最近映像重建会得到零点八纳米。命令执行成功,也没有缺失输出,但它不再遵循完整链的路径。对长分子,可以在满足相邻选点足够接近的条件下适当抽取点,不能不检查跨度就仅保留两个末端。

选择实体时,还要避免把两个独立分子混成一个需要连起来的对象。重建命令处理的是你给定的列表,不会替你判断生物学上哪些原子属于同一条链、哪一个跨链间隔应该保留。实际项目中应保存原子编号与拓扑的映射,并检查几帧最容易跨界的构象。这样比只在第一帧验证一次更容易发现隐藏的问题。

偏置能量为零,也可能来自错误的变量

接着给重建后的距离增加谐和约束。目标距离设为零点八纳米,力常数设为每摩尔每平方纳米一百千焦。正确端到端距离是一点二纳米,因此偏离目标零点四纳米。按二分之一乘力常数再乘偏差平方计算,偏置能量应为每摩尔八千焦,三帧的实际输出与这一结果一致。RESTRAINT 的势能公式

spring: RESTRAINT ARG=whole AT=0.8 KAPPA=100
PRINT ARG=whole,spring.bias STRIDE=100 FILE=COLVAR

只用两个端点重建的错误例子,输出距离刚好变成零点八纳米,偏置能量随之变成零。这个数字没有说明原来那条完整链达到了目标构象,而是说明程序按当前错误定义计算的变量恰好等于目标。只看偏置能量小不小,会遗漏这种问题。至少应同时检查变量本身、目标值、单位,以及它们对应的实际几何。

后处理计算出偏置能量,也不等于已经把这项偏置作用到原来的轨迹。本次三帧坐标在读取后没有通过动力学重新演化,不能因为输出了能量就声称完成了加偏置采样。真正接入模拟时,还要检查偏置与宿主引擎的力和积分步骤如何衔接,并用适当的体系测试实际行为。

同一条链,距离为何不同?。六组后处理实跑|先核对周期几何与单位,再解释偏置。。周期边界,最近映像 0.8 nm,完整链 1.2 nm,重建坐标后,距离计算仍需选择合适的周期规则。。变量定义,只重建两个末端,偏置能量变成 0,命令成功不代表它测到了所需的端到端距离。。单位,正确换算为 8,错误设置约 6272,单位均为 kJ/mol;分别检查输入、内部单位和参数。。
六组后处理实跑|先核对周期几何与单位,再解释偏置。

轨迹读取单位与内部单位,要分两层核对

我们将相同坐标另存成埃,把所有长度数字放大十倍。读取时正确指定埃,内部仍使用默认纳米,重建后的输出继续是一点二纳米,偏置能量仍为每摩尔八千焦。这说明改变文件的数值表示并不要求改变研究对象,但读取工具必须知道输入数字代表什么。

如果把这份以埃写出的文件误当成纳米,同时也按错误单位读取盒子尺寸,程序会把它理解为放大十倍的体系。此时完整端到端距离变成十二纳米,在原目标和原力常数下,偏置能量约为每摩尔六千二百七十二千焦。这个结果来自本次实际运行,并不是一般体系中固定会出现的误差倍数。因为势能依赖的是距离与目标的差,再取平方,误差不能简单概括为能量总是放大一百倍。

另一种需求是让内部计算与输出也采用埃。这时要在输入开头设置长度单位,并同步换算所有有长度量纲的参数。本例的目标从零点八纳米换成八埃,力常数从每平方纳米一百,换成每平方埃一。正确换算后,距离输出为十二埃,而偏置能量仍为每摩尔八千焦。内部单位规则

单位处理 完整链距离 偏置能量
正确读取埃,内部用纳米 1.2 nm 8 kJ/mol
埃误读为纳米 12 nm 6272 kJ/mol
内部改埃,参数一起换算 12 Å 8 kJ/mol
内部改埃,仍沿用旧参数数值 12 Å 6272 kJ/mol

这里最后一行与第二行产生了相同的数值能量,却来自不同的设置错误。仅凭最终结果无法唯一判断问题出在哪一层。排查时应分别记录轨迹坐标单位、盒子单位、内部单位和偏置参数单位,并用一个已知长度检查整个读取过程。对距离以外的变量,还要分别核对角度、时间或其他参数的量纲,不能认为设置一次长度就完成了全部换算。

输出时间轴也需要可解释的来源

本例将动力学时间步参数设为零点零零二皮秒,将轨迹帧间隔设为一百步。三帧输出时间因此是零、零点二和零点四皮秒。这只是我们为自建帧指定的示范时间轴,没有实际模拟出零点四皮秒的物理运动。迁移到真实轨迹时,这两个参数应来自生成轨迹的记录,不能根据文件中恰好有多少帧倒推一个方便的数值。

后处理输入中的打印步长还会与原始步数对应。本次打印步长为一百,所以三个输入帧都被记录。若把原轨迹每隔多少步保存一帧的设置漏掉,可能得到错误的时间轴或输出频率。观察分子转变快慢、计算相关性或比较不同轨迹时,这种错误会继续传到后续解释。driver 的单位与时间参数

我们读取结果时按字段名称定位数值,并核对输出行数、三个时间点和每个预期距离。这样可以避免修改打印内容后仍沿用旧列号,错把时间或另一种距离当作目标变量。文件中的字段说明应随输出一起保存,不能只把数值列复制到一个没有单位和变量名称的新表格里。

安装实测中,哪些信息应该留下来

本次从官方 v2.10.2 标签对应的源码构建,提交为 90dec6d6ebf97ad5f2580e50e563b70c1728c4e6,长版本命令报告二点十点二。编译使用 GCC 十一点四,关闭了本例不需要的 MPI、OpenMP 和 Python 扩展。轨迹生成与核验脚本使用 Python 三点十,通过独立命令行进程调用已安装的软件。官方源码

安装时曾尝试只保留少数功能模块,首次链接因遗漏轨迹相关模块而失败。补齐所需模块后构建完成。随后还需让运行环境能够找到安装目录中的共享库,单独把可执行文件路径写对并不足够。附件记录了最终成功的配置与运行方式。读者遇到类似问题时,应分别检查编译是否完成、动态库能否加载、所需功能是否存在,再检查具体输入,不要把所有启动错误都归到轨迹内容上。

下载六组 PLUMED 实跑脚本、源码安装说明与预期结果。脚本会自行生成小轨迹,保存每组输入、日志和结果,再独立验算距离与谐和能量。已完成安装后,可按下面的方式运行,具体安装目录替换为自己的位置。

export LD_LIBRARY_PATH="$PWD/plumed_prefix/lib"
python3 247-plumed/run.py \
  --plumed "$PWD/plumed_prefix/bin/plumed" \
  --out "$PWD/plumed_check"

PLUMED 的价值在于把变量定义和偏置方案明确写成可检查的输入,并能先用已有轨迹审阅这些定义。它也要求使用者对原子选择、周期几何和单位负责。先让几个已知构象产生能够手算核对的结果,再扩展到复杂体系,能够在长时间采样之前发现许多定义错误。至于变量是否足以描述真实转变、采样是否覆盖重要状态,则仍需要后续独立验证。

需要把验收过的变量与偏置方案用于多窗口或多副本计算时,可向云生信生物信息分析服务器说明宿主引擎、轨迹规模和采样计划,沟通相应环境安排。

把知识用于当前任务

下一步可以直接开始分析

按研究目标查找在线工具、课程、计算资源或完整分析服务。

按目标找方案仍有疑问,联系客服 ↗