pdb2reaction ドキュメント¶

バージョン: v0.4.0

pdb2reaction は、機械学習原子間ポテンシャル（MLIP: Machine Learning Interatomic Potential）を使用して、PDB 構造から酵素反応経路を自動的に解明する Python 製 CLI ツールキットです。

クイックスタート¶

目的	ワークフロー
End-to-end 初回実行	クイックスタート: all
反応物のみ	クイックスタート: scan
TS 候補あり	クイックスタート: TS のみモード
実行失敗 / エラー	典型エラー別レシピ

前提条件は Installation を参照してください。

サブコマンド¶

サブコマンド	説明
`all`	end-to-end ワークフロー: 抽出 → スキャン → MEP 探索 → TS 最適化 → IRC → 熱化学 → DFT
`extract`	タンパク質–リガンド複合体から活性部位モデル（バインディングポケット）を抽出
`fix-altloc`	PDB の代替位置指示子を解決
`add-elem-info`	PDB の元素カラム（77–78）を修復
`opt`	単一構造の構造最適化（L-BFGS または RFO。[+ 任意 flatten]）
`tsopt`	遷移状態最適化（Dimer または RS-I-RFO。[+ 任意 flatten]）
`path-opt`	GSM または DMF による 1 段階の MEP 最適化（2 構造から）
`path-search`	自動精密化を伴う多段階の再帰的 MEP 探索（2 構造以上）
`scan`	拘束付き 1D 結合長スキャン
`scan2d`	2D 距離グリッドスキャン
`scan3d`	3D 距離グリッドスキャン
`freq`	振動解析と熱化学
`irc`	固有反応座標（IRC: Intrinsic Reaction Coordinate）計算
`dft`	DFT 一点計算（GPU4PySCF / PySCF）
`sp`	MLIP による一点計算（エネルギー + 力）
`trj2fig`	XYZ 軌跡からエネルギープロファイルをプロット
`energy-diagram`	数値入力からエネルギーダイアグラムを作成
`bond-summary`	連続構造間の共有結合変化を検出・レポート

設定・リファレンス¶

トピック	ページ
CLI 規約と入力要件	CLI 規約
クラスター境界の凍結原子（キャップ水素・ `--freeze-atoms`）	凍結原子
よくあるエラーと対処	トラブルシューティング
CLI コマンドリファレンス（英語のみ、自動生成）	コマンドリファレンス（英語のみ）
YAML 設定オプション	YAML リファレンス
MLIP バックエンド設定	MLIP 計算機
用語	用語集

システム要件¶

ハードウェア¶

OS: Linux
GPU: CUDA 12.x 互換
VRAM: 8 GB 以上推奨
RAM: 16 GB 以上推奨

ソフトウェア¶

Python >= 3.11
CUDA サポート付き PyTorch
CUDA 12.x ツールキット

セットアップはインストールを参照してください。

エージェントスキル¶

pdb2reaction は、CLI サブコマンド・構造 I/O・バックエンドインストール・ワークフロー・出力解析・HPC 運用をカバーする AI エージェント向けの手順書を skills/ に同梱しています。完全なスキル索引とインストール手順は skills/README.md を参照してください。

引用¶

pdb2reaction を研究で利用する場合は、ChemRxiv プレプリントを引用してください:

@misc{ohmura2026pdb2reaction,
  author       = {Ohmura, Takuto and Sato, Hajime and Terada, Tohru},
  title        = {pdb2reaction: End-to-End Reaction-Path Elucidation from PDB Structures Using Machine-Learning Interatomic Potentials},
  year         = {2026},
  doi          = {10.26434/chemrxiv.15003538},
  note         = {ChemRxiv preprint}
}

ソフトウェアまたは特定のリリースを引用する場合は、Zenodo レコードを使用してください:

@software{ohmura2026pdb2reaction_software,
  author       = {Ohmura, Takuto},
  title        = {pdb2reaction},
  year         = {2026},
  month        = {6},
  version      = {0.4.0},
  url          = {https://github.com/t-0hmura/pdb2reaction},
  license      = {GPL-3.0},
  doi          = {10.5281/zenodo.19197865}
}

ライセンス¶

pdb2reaction は GNU General Public License version 3 (GPL-3.0) の下で配布されています。

ヘルプ¶

# 一般的なヘルプ
pdb2reaction --help

# コマンドのヘルプ
pdb2reaction <subcommand> --help

# 詳細オプション（dry-run、内部チューニング等）
pdb2reaction <subcommand> --help-advanced

問題や機能リクエストについては、GitHubリポジトリを参照してください。