该工作流已在 Linux x86_64 CPU 环境使用公开 1EVE/E20 示例完成实际计算验证。GNINA 1.3.3 生成三个 pose,PoseBusters 0.6.5 检查全部构象,PLIP 2.4.0 完成全部构象的分析且化学身份一致。这是计算工作流验证,尚未进行科学实验或生物活性验证。
用途与机制
GNINA 的 -r 是受体,-l 是独立准备的三维配体,--autobox_ligand 是与受体同坐标系的参考配体。参考定义口袋,因此不是盲对接。初始配体不必已在口袋内,真实日志记录其初始位姿在框外,随后搜索生成新构象。显式保留 CNN rescore,记录二进制哈希,原样保留实际评分字段,不从其他版本猜列名。请求三个模式是上限,本次实际得到三个。
明确输入准备
受体采用 1EVE 已观察到的 A 链,删除全部 HETATM,包括 E20、NAG/糖基和水。PDBFixer 1.12.0 补齐 ASP A:2、HIS A:3 的八个侧链重原子及 THR A:535 的 OXT;最终重原子 4263 个,原有重原子坐标移动为零。未建模未观察到的末端残基。OpenMM 8.6.1 在 Reference 平台按 pH 7.4 规则添加受体氢。E20 保留中性 CCD 身份,不宣称它是生理条件下的微观状态。参考为 E20:A:2001,28 个重原子,InChIKey 为 ADEBPBSSDYVVLD-HXUWFJFHSA-N。对接输入从异构分子图以 ETKDGv3、种子 20261019 和 MMFF 独立生成,未复制晶体位姿。
真实结果
| 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}
gnina -r "$INPUT_DIR/receptor.pdb" -l "$INPUT_DIR/ligand.sdf" \
--autobox_ligand "$INPUT_DIR/reference.sdf" --seed 20261019 \
--num_modes 3 --exhaustiveness 8 --cpu 2 --no_gpu \
--cnn_scoring rescore -o "$RUN_DIR/dock/poses.sdf"
以下命令保留实际计算参数,路径已改为示例。请将 /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。