pdb2reaction ドキュメント¶

バージョン: v0.3.7

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

ここから始める¶

目的	移動先
はじめての方	クイックスタート: all
反応物のみ	クイックスタート: scan
TS 候補がある	クイックスタート: tsopt + freq
エラーで止まった	典型エラー別レシピ

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

サブコマンド¶

サブコマンド	説明
`all`	end-to-end ワークフロー: 抽出 → スキャン → MEP 探索 → TS 最適化 → IRC → 熱化学 → DFT
`extract`	タンパク質–リガンド複合体から活性部位モデル（バインディングポケット）を抽出
`fix-altloc`	PDB の代替位置指示子を解決
`add-elem-info`	PDB の元素カラム（77–78）を修復
`opt`	単一構造の構造最適化（L-BFGS or RFO。[+ 任意flatten]）
`tsopt`	遷移状態最適化（Dimer or 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）
`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 を説明するプレプリントを準備中です。現時点では、本ソフトウェア自体を引用してください:

@software{ohmura2026pdb2reaction,
  author       = {Ohmura, Takuto},
  title        = {pdb2reaction},
  year         = {2026},
  month        = {4},
  version      = {0.3.6},
  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リポジトリをご覧ください。

本ドキュメントは各リリースに対応してバージョン管理されています。