原子マッピングは、既に与えられた反応の両側の原子に対応ラベルを付ける処理です。RXNMapper は反応言語モデルの注意重みから対応を提案します。未知の生成物を補ったり、合成経路を設計したり、機構や実施済み反応を証明したりする処理ではありません。本稿は反応物・生成物の記録を持つデータ管理者向けです。
入力方針を先に決める
Reaction SMILES は通常 reactants>agents>products と書き、reactants>>products では中央欄が空です。同じ側の成分はドットで区切ります。試薬を中央に置くか左へ移すか除くかを記録してください。原子の供給源が変わるためです。元の文字列は常に残します。
下の最小例は両側が空でない left>>right だけを受け付けます。これは監査を簡単にする限定方針であり、RXNMapper 全体の対応形式を限定する説明ではありません。未解決のプレースホルダー、不正分子、既存マップラベルは、意味を黙って変えず拒否します。不正入力を任意の文字削除で修復しないでください。
公式 README は RXNMapper().get_attention_guided_atom_maps(...) と mapped_rxn、confidence を示します。実装 には既定の同梱モデルの場所があります。2026-10-18 の PyPI は 0.4.3 です。広い Python 要件は、あらゆる RDKit/PyTorch/Transformers の組合せを実測した保証ではありません。実行前に環境全体を固定します。
結果を作り上げない最小監査例
次は脱水素を表す説明用の文字列をマッピングし、元入力、出典ラベル、入力ハッシュを保持する例です。実験反応記録ではなく、省略された水素収支も検証していません。Code status: not executed(未実行)。マップ済み文字列やスコアの値は提示しません。
import hashlib
import json
from collections import Counter
from rdkit import Chem
from rxnmapper import RXNMapper
def parse_pair(text):
if text.count(">") != 2 or text.count(">>") != 1:
raise ValueError("This example requires left>>right")
sides = text.split(">>")
if not all(sides):
raise ValueError("Empty reaction side")
mols = [Chem.MolFromSmiles(side) for side in sides]
if any(mol is None for mol in mols):
raise ValueError("Unparseable reaction side")
return mols
raw = "CCO>>CC=O"
record = {"source_id": "synthetic-example", "raw_rxn": raw,
"input_sha256": hashlib.sha256(raw.encode()).hexdigest()}
try:
original = parse_pair(raw)
if any(a.GetAtomMapNum() for m in original for a in m.GetAtoms()):
raise ValueError("Existing atom maps require a separate policy")
result = RXNMapper().get_attention_guided_atom_maps([raw])[0]
mapped = result["mapped_rxn"]
mols = parse_pair(mapped)
flags = []
maps = []
for mol in mols:
labels = [a.GetAtomMapNum() for a in mol.GetAtoms() if a.GetAtomMapNum()]
if any(n > 1 for n in Counter(labels).values()):
flags.append("duplicate_positive_label_on_one_side")
maps.append({a.GetAtomMapNum(): a.GetAtomicNum()
for a in mol.GetAtoms() if a.GetAtomMapNum()})
if any(maps[0][k] != maps[1][k] for k in maps[0].keys() & maps[1].keys()):
flags.append("element_mismatch")
if maps[1].keys() - maps[0].keys():
flags.append("unmatched_product_labels")
if any(a.GetAtomMapNum() == 0 for a in mols[1].GetAtoms()):
flags.append("unmapped_product_atom")
record.update(mapped_rxn=mapped, confidence=result.get("confidence"),
flags=flags, status="needs_chemical_review")
except Exception as exc:
record.update(status="failed", error_type=type(exc).__name__)
print(json.dumps(record, ensure_ascii=False))
出典は意図的に synthetic-example としています。実際の accession や版は追跡可能なデータにだけ付けます。環境に加えてソフトウェア・モデルファイルのハッシュと設定も保存してください。リポジトリの MIT コードライセンスとは別に、学習・元データとモデル資産の再利用条件を確認します。
返却された対応を点検する
マップ済み SMILES のパース成功は最初の確認です。同じ側では正のラベルが一つの原子を指し、両側で共有するラベルは元素を保つ必要があります。同位体、電荷変化、原子価、結合変化、立体化学も別途確認します。例のコードは一部の構造条件を調べ、生成物にだけあるラベルを要確認にします。
すべての反応物原子が記録された生成物に現れる必要はありません。脱離基、塩、省略副生成物があるためです。一方、由来不明の生成物原子は供給成分の欠落や不完全な出典を示す場合があります。対称原子や等価表現、対応の曖昧さにより、複数の化学的に妥当なマップも生じます。結合変化と元の文脈を確認してください。
confidence は内部スコアであり、校正済みの正解確率や実験収率ではありません。本稿は普遍的な閾値を設定しません。必要なら独立した人手レビュー集合で選び、誤受け入れと誤拒否の両方を報告します。
一括処理で失敗を隠さない
公式の BatchedMapper は不正入力に対して例外の代わりに区切り文字や空情報を返すことがあります。これを成功件数に入れないでください。各入力 ID に一つの状態を残し、前処理での拒否、モデル例外、空出力、人手確認を区別します。除外によって分母が変わる場合は明示します。
バッチサイズ、版、モデル ID、デバイス、正規化を記録します。キャッシュはデータ方針に従います。デバッグログも未公開構造を含み得ます。例では例外型だけを保存しますが、本番の生文字列やスタックトレースも保存前に点検が必要です。
ORD の来歴を別に保持する
Open Reaction Database のデータリポジトリ はデータセット・反応の識別子を持つ構造化記録です。一本の文字列に条件、役割、測定、来歴のすべては残りません。dataset ID、reaction ID、revision・ファイルハッシュ、変換規則と元ライセンスを保存します。現在のファイル・schema 資料を確認し、古い形式を前提にしないこと。
マップ番号は特定表現の添字であり、データベース全体で安定した化学識別子ではありません。元と正規化後を保存して初めてモデル入力を再構成できます。取得可能な出典とパース可能なマップは、権利や実験の信頼性を証明しません。
受け入れと次の工程
パース、ラベル整合性、出典の完全性、用途に応じた化学レビューを記録してから受け入れます。未解決の化学は人手確認へ回し、欠落種を作り足しません。反応中心解析やテンプレート抽出には使えますが、別タスクです。既存の逆合成 Recipe は関連資料であり、RXNMapper パイプラインの実行実績や CARS 統合ではありません。
ChemAI Atlasの関連資料とワークフロー
RxnMapper · RDKit · Open Reaction Database
逆合成ツール評価の計画 · 化学AIデータセットの出典とライセンス
出典と根拠の状態
資料確認日:2026-10-18。能力・API の記述は一次資料に基づき、監査・受け入れ手順は編集上の提案です。科学的検証や性能の実測を報告するものではありません。