该工作流已在 Linux x86_64 CPU 环境使用公开 1EVE/E20 示例完成实际计算验证。GNINA 1.3.3 生成三个 pose,PoseBusters 0.6.5 检查全部构象,PLIP 2.4.0 完成全部构象的分析且化学身份一致。这是计算工作流验证,尚未进行科学实验或生物活性验证。

用途与机制

PLIP 需要蛋白-配体复合物,而不是孤立 SDF。修正后的组装器预留 LIG:Z:1,为 TER 分配独立序号,相应平移配体编号,并用重复 CONECT 目标记录 Kekulé 键阶;先检查原子数和坐标,再由 PLIP 独立核对化学身份。最初参考转换虽然零退出,却因 TER/CONECT 错位产生不同 InChIKey,该报告已拒绝并保留。PLIP 2.4.0 在指定目录输出 report.xml/report.txt,单独 --version 不可用,版本由帮助、包元数据和 XML 记录。接触数是规则描述,不能相加当成结合能。

明确输入准备

本篇使用真实三构象 GNINA SDF、同坐标系的 E20:A:2001 参考及修补并加氢的 A 链受体。PDBFixer 1.12.0 与 OpenMM 8.6.1 保留原重原子坐标系;中性 CCD E20、删除水/糖基均为明确选择。完整准备细节见 GNINA 教程。

真实结果

Pose index minimizedAffinity CNNscore PoseBusters PLIP total
0 -10.83538 0.9389097691 checks_passed 14
1 -10.87303 0.8397080898 validation_failed 9
2 -10.0518 0.8295055628 validation_failed 9

索引 0 的 28 项启用 PoseBusters 检查全部通过,索引 1、2 仅在 rmsd_≤_2å 为 False,其他启用项为 True。这是参考位姿标准未满足,不能笼统解释成几何全部错误。全部三个构象均送入 PLIP,后两者保留 validation_failed。每个 PLIP 报告均确认 LIG:Z:1、相同 E20 InChIKey 与 28 个重原子,没有静默删除候选或失败。

实测命令与文件衔接

PROJECT_DIR=/path/to/molecular-docking-validation
RUN_DIR="$PROJECT_DIR/runs/example-run"
INPUT_DIR="$PROJECT_DIR/data/prepared"
cd "$PROJECT_DIR"
mkdir -p "$RUN_DIR"/{dock,config,validation,complex,interactions}
plip -f "$RUN_DIR/complex/pose_001_complex.pdb" -x -t \
  -o "$RUN_DIR/interactions/pose_001"

以下命令保留实际计算参数,路径已改为示例。请将 /path/to/molecular-docking-validation 替换为自己的目录。前提是工具已安装、运行库可用且命令可从 PATH 调用,并在 data/prepared/ 放置准备好的 receptor.pdb、独立生成的 ligand.sdf 及同坐标系的 reference.sdf。PoseBusters 还需将安装包中的 redock.yml 复制到 runs/example-run/config/redock.yml;PLIP 需要预先组装各受体—构象 PDB 复合物,并检查原子序号、TER/CONECT、键阶、坐标和化学身份。本文未提供完整项目、准备后的数据或组装脚本下载,因此这些是有前置条件的命令示例,不能直接复制即完成全流程。请使用新输出目录并保存输入、参数及日志。

失败与验收

实际负例覆盖缺失/无效受体、空/坏 SDF、PLIP 缺失文件、纯受体及平移后的零接触对照。GNINA 和 bust 对空/坏配体可能零退出但没有合法结果,必须检查文件、解析记录与完整覆盖。纯受体 PLIP XML 没有结合位点,和身份一致且已识别的配体零接触不同。原始错误与修正版产物均保留。GNINA 输出 space-groups.txt 警告,SDF 头标记也使 RDKit 依据非零 z 坐标判为三维;原始文件与警告未改写,三个构象均通过有限坐标及化学身份检查。

环境与解释范围

实测环境为 Ubuntu 24.04.2、Linux x86_64、2 vCPU、约 8GiB 内存、Python 3.12.15。项目使用独立环境和固定 GNINA 程序,SHA-256 为 3340c1f49cd3c7c84d8699182a1c6af13c7fa2a22448d1204640446106f72172。虽然使用 --no_gpu,该程序仍需 CUDA/cuDNN 加载库;这些库以及 Open Babel 所需 Xrender 均仅安装在项目环境,由独立环境设置加载路径,无需系统 CUDA 驱动或修改全局 Python。本机此次 GNINA 命令约耗时 45 秒,仅为单次观测,不保证其他运行时间。所记录的安装及共享缓存约占 8.3GiB;这是单次环境观测,不是最低存储需求。下载需要联网,不宣称通过隐私审计。

Docking/CNN 分数不等于实测亲和力、IC50 或药效。PoseBusters 检查启用的合理性与参考标准,PLIP 根据输入坐标按规则识别接触。单一已知口袋案例不证明普遍对接准确性、跨平台兼容性或生物活性。未独立计算预测 RMSD 数值,只保留 PoseBusters 配置中的 RMSD 阈值布尔结果。中性配体、删除水/糖基和保留末端截断均限制解释。

已发布资源

完整步骤与前置条件见配套 Recipe。

一手来源