PLUMED的PCA模态投影与参考距离
从已有Al13参考结构准备平均构型和两个SVD模态,运行PCARMSD,解释投影编号、向量缩放、MSD/RMSD及偏置原子力。
阅读本篇目录
下载四组完整输入、模态准备脚本、实际输出、CSV和图片(ZIP)。已有平均结构和模态向量时,PCARMSD可将当前结构叠合到平均结构,再输出模态投影与参考距离。本篇把准备文件、运行、读取和画图串起来。
1 先查看实际结果#
解压进入plumed-Al13-PCA:
bash read.sh
bash plot.sh
head -8 analysis/PLUMED-Al13-PCA-projections.csv

本例复用Al13 NEB的三个参考结构,先统一周期映像,再通过最优叠合和NumPy SVD构造两个示意模态。它们来自三幅参考,不是从平衡MD轨迹得到的统计主成分;图中方差比例只描述这个小参考集合。
六帧坐标为三个参考、两个相邻参考的线性插值中点和一个中点的整体旋转平移副本,没有新增DFT、NEB或MD计算。
2 准备平均结构与特征向量文件#
/public/toolkit/miniconda3/envs/ase-3.29.0/bin/python prepare-inputs.py
ls inputs-prepared/default-msd
cat inputs-prepared/default-msd/average.pdb
cat inputs-prepared/default-msd/eigenvectors.pdb
脚本对三幅参考做迭代最优叠合,求平均坐标,再用NumPy SVD生成两个方向。输出目录与本例实际使用的inputs逐字节比较;已有生成目录时停止。原子始终按相同的13个Al排序。
average.pdb存平均坐标,eigenvectors.pdb连续存放两个模态,分别以END结束。模态文件承载的是向量系数,不是两幅新的原子构型,不要把结构坐标当作模态直接写进去。
这个安装对向量文件也有PDB长度读入换算,且不会自动归一化向量。本例先定义单位范数的无量纲方向,再乘10写入Å格式列,以抵消读入时的0.1换算;在这个明确约定下,投影数值按nm解释。PDB采用0.001 Å文本精度,实际读入向量的范数在CSV中保留。更换向量尺度,会相应改变投影与偏置强度,不能只改文件后缀就使用其他程序的输出。
3 完整PCARMSD输入#
inputs/default-msd/plumed.dat:
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
p: PCARMSD AVERAGE=average.pdb EIGENVECTORS=eigenvectors.pdb NOPBC
b: RESTRAINT ARG=p.eig-1 AT=0 KAPPA=10
PRINT ARG=p.*,b.bias FILE=COLVAR STRIDE=1 FMT=%24.16e
当前安装实际输出字段为:
#! FIELDS time p.residual p.eig-0 p.eig-1 b.bias
这里eig-0是第一个模态、eig-1是第二个模态。本例偏置的是第二个模态;读取或修改输入时应按实际字段编号,不能将eig-1想当然地当成第一个。
residual默认是最优叠合后到平均结构的MSD,单位nm²。它不是从位移中减去这些主成分之后剩下的正交误差。
4 MSD、RMSD与权重的四组比较#
| 目录 | 设置与用途 |
|---|---|
| default-msd | 默认输出MSD,偏置第二个模态投影 |
| sqrt-residual | 加SQUARED_ROOT,输出RMSD,并对参考距离施加谐偏置 |
| numerical-projection | 原生NUMERICAL_DERIVATIVES,仍偏置第二个模态 |
| zero-pdb-weights | 平均PDB的occupancy、B-factor全改为0,检查本动作的权重行为 |
sqrt-residual完整输入为:
UNITS LENGTH=nm ENERGY=kj/mol TIME=ps
p: PCARMSD AVERAGE=average.pdb EIGENVECTORS=eigenvectors.pdb NOPBC SQUARED_ROOT
b: RESTRAINT ARG=p.residual AT=0.02 KAPPA=10
PRINT ARG=p.*,b.bias FILE=COLVAR STRIDE=1 FMT=%24.16e
增加SQUARED_ROOT后,p.residual变为RMSD,单位nm;投影值保持相同。这一组同时把偏置目标改为参考距离0.02 nm,因此不能把它的偏置能与默认投影偏置直接比较。

本例第一帧默认MSD约0.00115229 nm²,其平方根约0.0339454 nm。三幅参考的第二模态投影依次约−0.0105957、0.0217736、−0.0111122;整体平移旋转后的内部构象不变,投影与参考距离保持一致。
当前PCARMSD把对齐和位移权重都设为1,PDB中的occupancy、B-factor不会用来筛选或赋权。零权重文件这组的实际输出和默认组一致。需要改变原子选区时,应按一致的原子列表重新准备平均结构和模态,不能只靠改这两列。
5 提交、查看偏置与原子力#
sbatch run.slurm
squeue -u "$USER"
# 结束后读取新结果
bash read.sh work-new analysis-new
bash plot.sh analysis-new
head -8 analysis-new/PLUMED-Al13-PCA-forces.csv
脚本在新的work-new运行四组,保留参考结果;需要可用CPU队列资源。模板预留56核,实际单线程、不用GPU,每组原生分析约0.6秒。
使用PLUMED2.10.1,Intel oneAPI C++2024.2.1、IntelMPI2021.13编译,无需插件。NumPy负责叠合、SVD和数值读取,Matplotlib绘图。核心运行命令为:
source environment.sh
# 先复制所需inputs子目录到自己的新工作目录
plumed driver --plumed plumed.dat --ixyz trajectory.xyz --length-units nm --dump-forces forces.xyz --dump-forces-fmt %24.16e
默认组RESTRAINT ARG=p.eig-1 AT=0 KAPPA=10演示把第二模态投影偏向0。投影的向量缩放、原子选区和对齐方式都会影响偏置含义;本例参数用于操作演示,不直接作为其他体系的采样参数。原子力文件与CSV保留全部13个原子的笛卡尔偏置力。
6 换成自己的轨迹和模态#
先确保参考与轨迹的原子数、编号和顺序一致,并按适当方式处理周期边界。本例有限片段使用NOPBC;跨周期边界的生产轨迹应先正确重建。
要做MD主成分分析,需要用相应轨迹准备有代表性的平均结构和协方差模态,不能把本例三个NEB参考的方差比例解释为平衡涨落、时间尺度或动力学信息。包内读取/画图脚本针对13原子、两个模态及六帧,换体系时需要相应调整。
定义与输入说明见官方PCARMSD文档,当前实现细节见对应版本源码。