跳转到正文
社区

本地分子对接、构象质检与相互作用分析

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

难度: 高级 费用: 免费 隐私: 本地 ~60 分钟

编辑更新于:

开始安装
在 WorkBuddy 中打开
第三方服务

关于 WorkBuddy

此功能由第三方 WorkBuddy 提供,并非 ChemAI Atlas 官方运行环境。

点击后将跳转至外部网站,数据处理和服务使用受 WorkBuddy 自身条款约束。

此应用为实验性应用,部分配方仅支持配置辅助,不保证能够直接执行。

你将能够

  • 审计构象文件与计算合理性
  • 保留相互作用报告来源

你将构建什么

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

实测环境为 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 阈值布尔结果。中性配体、删除水/糖基和保留末端截断均限制解释。

安装时间为估计值,并非安装总耗时实测结果。

gnina

GNINA

posebusters

PoseBusters

plip

PLIP

组合组件

GNINA

gnina · 1.3.3; upstream binary SHA-256 pinned

已在 Linux x86_64 CPU 环境实际运行。

查看资源

PoseBusters

posebusters · 0.6.5

已在 Linux x86_64 CPU 环境实际运行。

查看资源

PLIP

plip · 2.4.0

已在 Linux x86_64 CPU 环境实际运行。

查看资源

兼容环境

客户端操作系统架构版本要求
Python 支持Linuxx86_64>= 3.12

安装与测试

1. 检查受控项目环境

Linux

以下命令保留实际计算参数,路径已改为示例。请将 /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、键阶、坐标和化学身份。本文未提供完整项目、准备后的数据或组装脚本下载,因此这些是有前置条件的命令示例,不能直接复制即完成全流程。请使用新输出目录并保存输入、参数及日志。 实际验证仅覆盖 Linux x86_64 CPU、2 vCPU、约 8GiB 内存,未验证 GPU 或 macOS/Windows 原生兼容性。

不要覆盖已有运行与环境;使用新的版本化路径。

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}
python --version
gnina --version
bust --version
plip --help
官方来源

预期结果

保存版本

2. 配置独立工具与加载库

Linux

按各工具的官方安装说明,在独立环境中安装 GNINA 1.3.3、PoseBusters 0.6.5、PLIP 2.4.0、PDBFixer 1.12.0 和 OpenMM 8.6.1。实际计算使用 Python 3.12.15。对照说明中的 GNINA 程序摘要核验下载,并确保工具可从 PATH 调用。该程序即使用 --no_gpu 也需要 CUDA/cuDNN 加载库,PLIP/Open Babel 还需要 Xrender。初始依赖检查曾因缺库失败,随后在项目环境内补齐,无需系统 CUDA 驱动或修改全局 Python。依赖检查非零意味着环境仍需修复。本文不提供环境配置脚本或完整环境包下载。

不要覆盖已有运行与环境;使用新的版本化路径。

官方来源

预期结果

修复后环境依赖检查通过

3. 准备固定公开结构

Linux

来源为公开 RCSB PDB 1EVE 结构及 CCD E20 配体定义。实际计算复用先前获取且经 SHA-256 核对身份的源文件,运行时未重新下载。请自行获取并确认来源,保留来源记录与哈希,将 receptor.pdb、ligand.sdf、reference.sdf 准备到 data/prepared/。本文不提供准备后的文件或准备脚本下载。受体采用 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 独立生成,未复制晶体位姿。

不要覆盖已有运行与环境;使用新的版本化路径。

官方来源

预期结果

三个准备文件且无剩余缺失重原子

4. GNINA 生成真实构象

Linux

请使用新输出目录,RUN_DIR 是示例路径。保存 stdout/stderr 和参数。实跑生成三条有限三维 SDF,InChIKey 一致,实际属性有 minimizedAffinity、CNNscore、CNNaffinity、CNN_VS、CNNaffinity_variance;不能由名称推断实测亲和力。

不要覆盖已有运行与环境;使用新的版本化路径。

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"
官方来源

预期结果

三个可解析 GNINA pose

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

5. PoseBusters 逐条检查

Linux

复制包内 posebusters/config/redock.yml 到 $RUN_DIR/config/redock.yml 并记录哈希。每条 SDF 必须对应 CSV 一行,保留全部布尔值。索引 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"
官方来源

预期结果

三行结果,索引 0 通过全部启用检查

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

6. 组装并用 PLIP 检查全部构象

Linux

调用 PLIP 前,需将各选定 SDF 构象与准备后的受体在同一坐标系中组装为复合物,保留配体键阶,将配体标识为 LIG:Z:1,并同步原子序号、TER 和 CONECT。本文不提供组装脚本,因此这些 PDB 复合物是命令的前置输入。所示命令分析索引 0 对应的 pose_001_complex.pdb。实际计算对索引 0、1、2 分别组装并分析,使用独立的 complex/pose_XXX_complex.pdb 和 interactions/pose_XXX。每份 XML 必须确认 LIG:Z:1、E20 InChIKey 与 28 个重原子,并解析 XML 和非空文本;索引 1、2 保留 validation_failed。实际报告文件名为 report.xml/report.txt。

不要覆盖已有运行与环境;使用新的版本化路径。

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"
官方来源

预期结果

三份身份一致的 XML/TXT

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

7. 执行负例并冻结 manifest

Linux

实际负例覆盖缺失/无效受体、空/坏 SDF、PLIP 缺失文件、纯受体及平移后的零接触对照。GNINA 和 bust 对空/坏配体可能零退出但没有合法结果,必须检查文件、解析记录与完整覆盖。纯受体 PLIP XML 没有结合位点,和身份一致且已识别的配体零接触不同。原始错误与修正版产物均保留。GNINA 输出 space-groups.txt 警告,SDF 头标记也使 RDKit 依据非零 z 坐标判为三维;原始文件与警告未改写,三个构象均通过有限坐标及化学身份检查。 新的计算应将失败对照保存在独立输出目录,核对成功路径、来源身份、输入输出哈希与库版本。本文不提供负例或 manifest 生成脚本下载。计算执行成功不代表生物活性成立,尚未进行科学实验验证。

不要覆盖已有运行与环境;使用新的版本化路径。

官方来源

预期结果

预期负例被拒绝且 manifest 哈希一致

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

故障排除

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

仍无法运行

替代方案

本例未验证 Uni-Dock,采用时需独立检查输入、GPU 要求、准备流程与评分。参考结构自检不能替代对接。

相关指南

引用本页

ChemAI Atlas. 本地分子对接、构象质检与相互作用分析. 更新于 . https://chemaiatlas.com/zh/recipes/local-molecular-docking-pose-validation/