概要
RDKit Skill (K-Dense) は、Scientific Agent Skills コレクションに含まれる個別のリソースです。ケモインフォマティクスのタスクに RDKit を適用するための説明、参考資料、任意のヘルパースクリプトを提供しますが、RDKit ライブラリそのものでも、単独で動作するエージェントでもありません。分子を詳細に制御する必要がある場合、独自のサニタイズが必要な場合、または特殊なアルゴリズムを使う場合は RDKit を推奨し、標準的なワークフローにはより簡便なラッパーとして datamol を紹介しています。
記載されたワークフローは、SMILES、SDF、MOL、InChI などの分子構造から始まり、解析、検証、分析、任意の変換へと進みます。対象となる出力には、分子記述子、フィンガープリント、類似性の結果、部分構造の一致、反応生成物、座標、可視化が含まれます。同梱された3つの Python ヘルパーは、分子特性、フィンガープリントに基づく類似性スクリーニング、部分構造フィルタリングに対応します。補足資料には、API の詳細、記述子の定義、SMARTS パターン、ワークフロー上の留意点がまとめられています。
化学的な解釈は、明示的に利用者の責任として残されています。異性体を正規化した SMILES を使っても、互変異性体、プロトン化状態、塩、未指定の立体化学が自動的に統一されるわけではありません。ヘルパーは無効なレコードを除外する際に元の識別子を保持し、塩の除去や構造の中和を暗黙に行いません。フィンガープリントの類似度は同一性を判定するものではなく、検索ヘルパーが受け付けるのは有効なクエリ分子1つであり、複数のクエリではありません。従来の pains オプションに含まれるのは例示的なモチーフ5つのみで、公刊された PAINS カタログではありません。記述子のしきい値、QED、アラートは研究上のヒューリスティックであり、生物活性や安全性の証拠ではありません。ヘルパースクリプトには rdkit パッケージのインストールが必要です。Skill が提供するのはガイダンスであり、その依存関係ではありません。
主な機能
- SMILES、SDF、MOL、InChI、手動サニタイズ、化学的問題の検出など、分子の入出力と検証に関するガイダンス。
- MW、LogP、TPSA、水素結合数、Morgan/ECFP、MACCS、類似度指標、Butina クラスタリングを含む、記述子とフィンガープリントのワークフロー。
- 一致箇所の取得、反応の適用、反応フィンガープリントなど、SMARTS による部分構造検索と反応 SMARTS のガイダンス。
- 2D 描画、ETKDG 埋め込み、力場最適化、アラインメント、および後続処理の前にコンフォマー生成の失敗を確認する手順。
- 同梱された3つの Python ヘルパー：`molecular_properties.py`、`similarity_search.py`、`substructure_filter.py`。直接利用することも、ワークフローのひな形として使うこともできます。
- 元の構造と識別子の保持、CXSMILES 出力での拡張立体化学の保持、明示的な標準化方針など、化学的な意味を損なわないための注意事項。
用途
- 評価案：分子コレクションの記述子テーブルを作成し、追跡可能性のために元の構造と識別子を保持する。
- 評価案：フィンガープリントを使って化合物コレクションを1つのクエリ分子と照合し、候補を確認する。ただし、類似性を化学的な同一性とみなさない。
- 評価案：タスクに応じた SMARTS パターンで構造をフィルタリングし、アラートを解釈したり化合物を除外したりする前に一致を検証する。
- 評価案：分子描画またはコンフォマー生成ワークフローのプロトタイプを作成し、下流の分析前に解析と埋め込みの失敗を確認する。
使い方
- 指定された Skill ファイルを読み、適切なワークフローを選んで、その説明と RDKit の依存関係を区別してください。
- コレクションリポジトリから
skills/rdkitのリソースを取得します。rdkitのインストールには Skill の環境ガイドを参照し、同一環境で conda と PyPI のインストールを混在させないでください。 - 記録された形式で分子入力を準備します。元の構造と ID を保持し、解析後の分子を検証し、標準化が適切かどうかを明示的に判断してください。
- ソースの説明に記載された参考ファイルを確認し、ヘルパーを選ぶか、例示されたワークフローを応用してください。類似性検索で指定できるのは、有効なクエリ分子1つです。
- まず、小規模で検査しやすいデータセットを使って評価します。無効なレコード、立体化学の扱い、SMARTS の一致、コンフォマー生成の失敗を確認してください。記述子やアラートは、検証済みの生物学的結論ではなく、研究上のヒューリスティックとして解釈してください。