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

用途与机制

PoseBusters 检查配置中的合理性与参考标准,不生成 pose,也不证明结合。本例复制并记录了安装包 redock.yml 的哈希。CLI 必须传 YAML 路径:早期 --config redock 失败,实测采用 --config "$RUN_DIR/config/redock.yml"。保留 file、molecule、position 标识,比较 CSV 与 SDF 条数并检查每个布尔值。输入加载、sanitization、立体信息、键长键角、内部碰撞和蛋白重叠回答不同问题。不可用结果不算通过;水/辅因子相关项也不能证明输入中建模了已移除成分。

明确输入准备

本篇使用真实三构象 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}
bust "$RUN_DIR/dock/poses.sdf" -l "$INPUT_DIR/reference.sdf" \
  -p "$INPUT_DIR/receptor.pdb" --config "$RUN_DIR/config/redock.yml" \
  --max-workers 0 --outfmt csv --output "$RUN_DIR/validation/posebusters.csv"

以下命令保留实际计算参数,路径已改为示例。请将 /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。

一手来源