cdxkit による ChemDraw 図の作成
cdxkit は、図の短い Python 記述を、ChemDraw で開いて完全に編集可能な CDXML ファイルと、ChemDraw のようにレンダリングされた PNG(600 dpi)の 2 つのファイルに変換します。
ライブラリはこのファイルと同じ場所の cdxkit/ にあります。examples/ にある例が、図がどのように構築されるかを確認する最も速い方法です。
1. 最初に内容とスタイルを決める
- 内容。どの反応、構造、条件、数値を含めるか、そしてそれらがどこから来たものか(論文、ユーザー自身の ChemDraw ファイル、メモ)を決めます。不足しているものがあれば尋ねてください。収率、条件、構造を記憶から埋めることは絶対に行わないでください。
- スタイル。スタイルは
styles/にあります。ユーザーが名前で指定した場合(または「第 1 章のようなスタイル」などと言った場合、styles/literature-rows.mdに変換)にのみ使用します。ユーザーがスタイルを指定しなかった場合は、一度だけ以下の選択肢を提示してください。acs-plain:ChemDraw の ACS Document 1996 デフォルト、白黒のみ(styles/acs-plain.md)。literature-rows:1行に1つの文献反応、意味が固定された数色、サイクル上の曲線の入/出力矢印(styles/literature-rows.md)。liu-group:計算化学図(エネルギー図、遷移状態、中間体)、劉グループの SOP に従う(styles/liu-group.md、「刘组风格」)。- ユーザーが提供する図や仕様に合わせる。 ユーザーが選択していないスタイルの色やレイアウト規則を適用しないでください。スタイルが指定されていないエネルギー図の場合は、最初に liu-group を提案してください。エネルギー図に関するルールがある唯一のスタイルです。
2. すべてのスタイルに共通するルール
-
ソースに忠実に。各構造をソースが描いている通りに描画します。同じ向き、同じ立体化学(「合わせる」ために生成物を反転したり左右反転したりしないでください。反転した図は異なる立体異性体を示唆します)。条件と数値は正確にコピーし、数値が何であるか(単離収率かNMR収率か、d.r.、ee)を明記してください。ソースが利用できない場合は、推測する代わりにその旨を伝えてください。
-
図内で一貫性を保つ。同じ種類のものは、1つの図の中でどこでも同じ方法で描画します(1つの化合物をある場所では構造式で、別の場所では縮合式で示さない。同じ略語、同じ結合長、同じラベルスタイル)。
-
ラベルが正しく読めるようにする。ラベルは、結合した原子が結合に接するように記述します。
- 右からの結合 →
OTIPSはTIPSOになります。 - 左からの結合 → 結合した原子で始めます。例:
Fe(CO)<sub>2</sub>Cp*。 - 上または下からの結合 → 結合した原子で始め、左揃えにします。例:
('OBBu<sub>2</sub>', 'left')。
ラベルは表示されるとおりに記述してください。CDXML では、cdxkit は ChemDraw の入力順序で結合の左側にあるラベルを保存します(
TIPSOはOTIPSとして保存されます)。これは、ChemDraw がファイルを開いたり保存したりするときにラベルをそのように読み取るためです。ラベルを自分で反転させないでください。 - 右からの結合 →
-
必ず確認する。PNG を常にレンダリングし、ユーザーに見せる前に表示してください。以下の点を確認します:反転または誤配置されたラベル、重なったテキスト、届いていない矢印、混雑した条件、中央揃えになっていない行、片側の余白。
-
ファイルをチェックする。
layout.save()はname: self-check PASSとWARNING:行を出力します。- PASS は、CDXML が RDKit で読み戻されたときに、同じノード、結合、有機骨格を持つことを意味します(
[Fe]、L、Arなどラベルのみで構成されたフラグメントは数のみチェックされます)。PNG の見た目については何も示しません。 - 2 つの警告は、ラベルに挟まれた結合に関するものです。どちらの場合も、結合を長くする(金属結合の場合は
L.ML)か、ラベルを移動します。- "bond X-Y … is hidden by its labels":結合が PNG に表示されていません(CDXML にはまだあります)。
- "bond X-Y … shows only n pt between its labels":結合が短すぎて読めません。約 4 pt より短い破線の TS 結合は実線のように見えます。
- Windows で ChemDraw がインストールされている場合、
cdxkit.chemdraw.export()は CDXML を ChemDraw で開き、ChemDraw でレンダリングされた PNG/CDX を保存します。ChemDraw が既に開いている場合は実行を拒否し(ユーザーが保存していない作業を持っている可能性があります)、自身が開始しなかった ChemDraw を終了することはありません。
- PASS は、CDXML が RDKit で読み戻されたときに、同じノード、結合、有機骨格を持つことを意味します(
-
引き渡し:
.cdxml(ChemDraw で編集するため)と.pngを提供し、ユーザーが手動で調整すべき点があればリストアップします(「制限事項」を参照)。
3. ライブラリの使用方法
import sys; sys.path.insert(0, r'<this skill folder>')
from cdxkit import Scene, mid, register_color
from cdxkit import layout as L
from cdxkit.cycle import Cycle
s = Scene() # ACS 1996: Arial 10 pt, bond 14.4 pt
m, box = L.place(s, 'C=CCC', 10, 60) # SMILES -> atoms; box = ink bbox
fe = s.add_atom_label(*L.metal_above(m[0], m[1]), '[Fe]<sup>+</sup>')
L.eta2(s, fe, m[0], m[1]) # dashed eta-2 line to the C=C midpoint
L.add_h(s, m[2], deg=-90, color='red') # explicit H (optional colour)
x = L.arrow_with_conditions(s, box[2] + 12, 60, above=['Et<sub>3</sub>N'], below=['CH<sub>2</sub>Cl<sub>2</sub>'])
L.place(s, '*CC=CC', x + 12, 60, labels={0: '[Fe]'})
L.save(s, 'out/figure') # out/figure.cdxml + .png, prints self-check
座標はポイント(1/72 インチ)で、y は下方向に増加します。角度は紙上で反時計回りの度数です(0 = 右、90 = 上)。
原子は位置で検索されます。 add_bond(p1, p2) は、p1/p2 にある原子(0.6 pt 以内)を接続します。そのため、既存の断片の上に別の断片を描画しないでください(「原点で描画して、後で移動する」は失敗します)。各部分を最終的な位置に描画するか、独自の Scene に描画して L.merge(s, part, dx, dy) でコピーします。RowFigure は各行に対してこれを自動的に行います。ライブラリは、原子が別の原子の上に配置されると警告し、save() は結合のないラベルをリストアップします。テキストは <sub> <sup> <i> <b>、\n、および HTML エンティティ(′ ′、π π、° °)を受け入れます。
| 機能 | 呼び出し方法 |
|---|---|
| サイズ | L.BL = 14.4 pt(C–C 結合)、L.ML = 21 pt(金属–配位子結合) |
| SMILES からの分子 | L.place(s, smi, left, cy, rotate=, flip=, labels={i: 'Ar'}, align_atom=None) → (AtomMap, ink box);cy はインクボックスを中央揃えにするか、原子 align_atom を高さ cy に配置します(鎖を矢印軸上に置くため)。L.place_center(...);L.ink_size(smi);L.orient(smi, i, j, deg, flip=) は、結合 i→j を deg の角度に向ける rotate を提供します(place と同じ flip を渡します)。AtomMap はスナップショットです。原子を移動した後は、再度検索してください。* 上の金属は C–C 長の結合を取得します。L.stretch(s, m[c], m[star], L.ML) で長くします。略語は * 原子に配置します。立体は SMILES で指定します。例:SMILES C/C=C(\*)c1ccccc1(Python 文字列内では 'C/C=C(\*)c1ccccc1')。 |
| 手描き断片 | `s.add_atom_label(x, y, text, align=None |
| ラベル/結合の色付け | s.paint(p, 'navy')(p の原子ラベル)、s.color_bond(p1, p2, 'red', style='bold') |
| 角度付きの点 | L.pol(p, deg, d=L.BL) |
| π 結合上の金属 | L.metal_above(a1, a2)、L.eta2(s, metal, a1, a2) |
| 明示的な H | L.add_h(s, p, deg=None, color=None)(deg=None: 開いた方向) |
| アレン中心ドット | L.allene_dot(s, p) |
| 矢印 | L.arrow_with_conditions(s, x1, y, above=[...], below=[...], eq=False)、`s.add_arrow(x1, y1, x2, y2, head='full' |
| 椅子型 / 舟型(6員環遷移状態) | L.chair(center, side=L.ML, mirror=False, flip=False) → 環順の 6 つの位置(教科書的な椅子型実線);L.boat(center, side=, mirror=, flip=) → ChemDraw の舟型テンプレートの位置(前面の辺を太線で、先端から前面の辺へのエッジをくさび型で描画します。docstring を参照)。L.polygon(center, n, side=) は平面環のみに使用します |
| エネルギー図 | 下記「エネルギー図」を参照 |
| テキスト | `s.add_text(x, y, text, align=, valign='baseline' |
| ボックス | L.fill_box(s, box_or_Mark, pad=4, fill='fill')(構造の背後にタイルを敷く)、s.add_rect(x, y, w, h, fill=, dashed=, rounded=)、L.label_box(s, x_right, y_base, text, fill)、s.add_bracket(...)、L.via_bracket(s, box) |
| 色 | パレット名 red navy grey fill rule redfill navyfill greyfill darkblue darkred(grey = #797979、darkblue #011993 および darkred #941100 が liu-group の経路色です);register_color('teal', '#13786F') で追加 |
| 反応ごとの行 | `L.RowFigure(width=468, title_position='top' |
| ピースの結合 | L.merge(s, part, dx, dy) はシーン part を s にコピーします |
| 触媒サイクル | 下記「触媒サイクル」を参照 |
| パーツの移動/測定 | mk = L.Mark(s) … 描画 … mk.bbox()、mk.shift(dx, dy) |
| 出力 | L.save(s, base) → base.cdxml、base.png + 自己チェック(s.check_cdxml は事前に s.to_cdxml が必要です。save は両方を実行します);cdxkit.chemdraw.export(cdxml, [png, cdx]) |
金属中心とラベル
-
原子ラベルは自動的にアンカーされます。
- 両側に結合があるラベル、または 3 つ以上の結合を持つラベルは、原子上で中央揃えになります(2 つの
PPh3を持つAr–Pd–X、L–Pd<sup>II</sup>–L)。 - 結合が右から来るラベルは右揃えになります(
Fp–CH2、TIPSO–)。 - それ以外の場合は左揃えになり、最初の文字が原子上に配置されます(金属の上または下の
PPh3)。
align='left'|'right'|'center'で上書きします。ラベルはその中央の文字(例:Cp*Fe(CO)2の Fe)にアンカーできません。結合した原子が最初または最後になるように記述してください。 - 両側に結合があるラベル、または 3 つ以上の結合を持つラベルは、原子上で中央揃えになります(2 つの
-
金属–配位子結合には
L.MLを使用します。2 つのラベルが近づきすぎて、それらの間の結合が消えてしまう場合、save()は警告します。
触媒サイクル
cyc = Cycle(s, cx, cy, r, clockwise=True, hook_radius=17, hook_sweep=72)
cyc.arc(62, 16) # 円弧矢印、16 度にヘッド(時計回り)
cyc.hook(54, 'in', 'base') # 試薬が 54 度で結合
cyc.hook(34, 'out', 'BH<sup>+</sup>') # 副生成物が 34 度で脱離
cyc.hook(148, 'in', draw_fn) # draw_fn(scene, (x, y)): 構造
cyc.label(26, 'deprotonation', dist=8, color='navy') # ステップ名、円弧の隣
- フックは
thetaでサイクルに接し、外側にカールします。時計回りのサイクルの場合、'in'フックの自由端は上流(theta の反時計回り)にあり、'out'フックの自由端は下流にあります。自由端が空白スペースに来るように theta を選択してください。 - ラベルまたは構造は自由端の先に配置されます。サイクルの右半分ではその右側に、左半分ではその左側に、上部と下部近くでは中央揃えになります。
side='left'|'right'|'center'で強制的に側面を指定します。gap=で距離を設定します。head_in='full'は'in'フックにヘッドを配置します。 cyc.labelは複数行テキスト('reductive\nelimination')を受け入れ、広いテキストを上部と下部の近くで円弧に接触しないように保ちます。それでも接触する場合はdistを増やします。- 10 pt テキストでの一般的なサイズ:r = 55–65 pt。
エネルギー図
from cdxkit.energy import EnergyProfile, load_energies, common_sides
E = load_energies('energies.csv', column='M06/def2-TZVP') # {label: kcal/mol}, 下記参照
ep = EnergyProfile(energies=E) # liu-group デフォルト;bars='bonds' はオプション
ep.path(['1', 'TS1', ('2', None, dict(add='R<sub>2</sub>C=O')), '3', 'TS3a',
('4a', None, dict(add='R<sub>3</sub>SiH', remove='LCuH')), ('5a', None, dict(shift=25))])
ep.path(['3', 'TS3b', '4b']) # 既知のラベルから開始 = そこで分岐
ep.structure('TS1', draw_ts1) # draw_ts1(scene) は任意の場所に TS を描画
# ep.note('M06/def2-TZVP/SMD(DCE)//B3LYP-D3(BJ)/6-31G(d)') # ユーザーが要求した場合のみ
ep.save('out/profile') # .cdxml + .png + チェック + 値の表
- 数値。ユーザーの表から取得し、記憶や古い図から決して取得しないでください。
- CSV は最初の列にラベル、1 列につき 1 つのメソッドを持ち、単位は 1 つの基準に対する kcal/mol です。ヘッダーが
#で始まる列は注釈です。空のセルまたは n.a. は値がないことを意味します。 - ラベルのみで指定されたステップは、その表で検索されます。
('TS1', 12.4)は直接値を指定します。表がない場合にのみ使用してください。 - 2 つの経路で同じラベルは 1 つのポイントです。両方で同じエネルギーを持つ必要があります。異なる化学種には異なるラベルを付けてください。
- CSV は最初の列にラベル、1 列につき 1 つのメソッドを持ち、単位は 1 つの基準に対する kcal/mol です。ヘッダーが
- ステップオプション(ステップに dict として指定):
add=、remove=:次のステップへの結合部に入る試薬、または出ていく生成物。at=、curve='above'|'below':その結合部上で曲線が接触する位置(0 から 1)と、結合部のどちら側に曲線が来るか。どちらかが省略された場合、ライブラリは曲線とそのテキストが何にも接触しなくなるまで位置と両側を試行します。shift=: 結合部上のスケールブレーク。