ChemDraw-Abbildungen mit cdxkit
cdxkit wandelt eine kurze Python-Beschreibung einer Abbildung in zwei Dateien um: ein CDXML, das sich in ChemDraw öffnen lässt und vollständig bearbeitbar bleibt, und ein PNG, das wie ChemDraw gerendert wird (600 dpi). Die Bibliothek befindet sich in cdxkit/ neben dieser Datei; die Beispiele in examples/ sind der schnellste Weg, um zu sehen, wie eine Abbildung aufgebaut wird.
1. Inhalt und Stil zuerst festlegen
- Inhalt. Welche Reaktionen, Strukturen, Bedingungen und Zahlen hineinkommen und woher sie stammen (eine Veröffentlichung, die eigene ChemDraw-Datei des Benutzers, seine Notizen). Wenn etwas fehlt, fragen Sie; füllen Sie niemals eine Ausbeute, Bedingung oder Struktur aus dem Gedächtnis.
- Stil. Stile befinden sich in
styles/. Verwenden Sie einen nur, wenn der Benutzer ihn namentlich verlangt (oder sagt z. B. „wie Kapitel 1“, „第 1 章那种风格“ →styles/literature-rows.md). Wenn der Benutzer keinen Stil genannt hat, fragen Sie einmal und bieten Sie an:acs-plain: ChemDraws ACS Document 1996 Standardeinstellungen, nur schwarz (styles/acs-plain.md);literature-rows: eine Literaturreaktion pro Zeile, einige Farben mit festgelegten Bedeutungen, gebogene hinein-/hinaus-Pfeile an Zyklen (styles/literature-rows.md);liu-group: Rechenabbildungen, d.h. Energieprofile, Übergangszustände und Intermediate, nach den SOPs der Liu-Gruppe (styles/liu-group.md; auch „刘组风格“);- einer vom Benutzer bereitgestellten Abbildung oder Spezifikation entsprechen. Wenden Sie keine Farben oder Layoutkonventionen aus einem Stil an, den der Benutzer nicht gewählt hat. Bieten Sie bei einem Energieprofil ohne benannten Stil zuerst den liu-group-Stil an: Es ist der einzige Stil mit Regeln für Profile.
2. Regeln, die in jedem Stil gelten
-
Quellentreu. Zeichnen Sie jede Struktur so, wie die Quelle sie zeichnet: gleiche Ausrichtung, gleiche Stereochemie (nicht spiegeln oder ein Produkt „umbiegen, um es einzufügen“; eine gespiegelte Zeichnung deutet auf ein anderes Stereoisomer hin). Kopieren Sie Bedingungen und Zahlen exakt, und geben Sie an, wofür eine Zahl steht (isolierte vs. NMR-Ausbeute, d.r., ee). Wenn die Quelle nicht verfügbar ist, sagen Sie dies, anstatt zu raten.
-
Innerhalb einer Abbildung konsistent. Die gleiche Art von Ding wird innerhalb einer Abbildung überall gleich gezeichnet (zeigen Sie nicht eine Verbindung als Struktur und eine andere als kondensierte Formel; gleiche Abkürzung, gleiche Bindungslänge, gleicher Beschriftungsstil).
-
Beschriftungen korrekt lesen. Eine Beschriftung wird so geschrieben, dass das gebundene Atom die Bindung berührt:
- Bindung von rechts →
OTIPSwird zuTIPSO; - Bindung von links → mit dem gebundenen Atom beginnen, z. B.
Fe(CO)<sub>2</sub>Cp*; - Bindung von oben oder unten → mit dem gebundenen Atom beginnen und linksbündig ausrichten, z. B.
('OBBu<sub>2</sub>', 'left').
Schreiben Sie Beschriftungen so, wie sie erscheinen sollen. Im CDXML speichert cdxkit eine Beschriftung, die links von ihrer Bindung sitzt, in ChemDraws getippter Reihenfolge (
TIPSOwird alsOTIPSgespeichert), weil ChemDraw Beschriftungen beim Öffnen oder Speichern einer Datei so liest. Kehren Sie Beschriftungen nicht selbst um. - Bindung von rechts →
-
Anschauen. Rendern Sie immer das PNG und betrachten Sie es, bevor Sie es dem Benutzer zeigen. Prüfen Sie auf: umgekehrte oder falsch platzierte Beschriftungen, überlappenden Text, Pfeile, die nicht reichen, überfüllte Bedingungen, Zeilen, die nicht zentriert sind, leeren Raum auf einer Seite.
-
Datei prüfen.
layout.save()gibtname: self-check PASSplus eventuelleWARNING:-Zeilen aus.- PASS bedeutet, dass das CDXML mit RDKit mit denselben Knoten, Bindungen und organischen Grundgerüsten zurückgelesen wird (Fragmente, die nur aus Beschriftungen wie
[Fe],L,Arbestehen, werden nur auf Anzahl geprüft). Es sagt nichts über das Aussehen des PNG aus. - Zwei Warnungen betreffen Bindungen, die zwischen Beschriftungen eingeklemmt sind; verlängern Sie in beiden Fällen die Bindung (
L.MLfür Metallbindungen) oder verschieben Sie die Beschriftungen:- „Bindung X-Y … ist durch ihre Beschriftungen verdeckt“: Die Bindung fehlt im PNG (sie ist noch im CDXML);
- „Bindung X-Y … zeigt nur n pt zwischen ihren Beschriftungen“: Die Bindung ist zu kurz zum Lesen. Eine gestrichelte TS-Bindung, die kürzer als etwa 4 pt ist, sieht durchgezogen aus.
- Unter Windows mit installiertem ChemDraw öffnet
cdxkit.chemdraw.export()das CDXML in ChemDraw und speichert ein von ChemDraw gerendertes PNG/CDX. Es weigert sich, zu laufen, während ChemDraw bereits geöffnet ist (der Benutzer könnte ungespeicherte Arbeit haben), und beendet niemals ein ChemDraw, das es nicht gestartet hat.
- PASS bedeutet, dass das CDXML mit RDKit mit denselben Knoten, Bindungen und organischen Grundgerüsten zurückgelesen wird (Fragmente, die nur aus Beschriftungen wie
-
Übergabe der
.cdxml(zum Bearbeiten in ChemDraw) und der.png, und listen Sie auf, was der Benutzer noch von Hand anpassen sollte (siehe Einschränkungen).
3. Verwenden der Bibliothek
import sys; sys.path.insert(0, r'<dieser Skill-Ordner>')
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, Bindung 14.4 pt
m, box = L.place(s, 'C=CCC', 10, 60) # SMILES -> Atome; box = Tintenbegrenzungsrahmen
fe = s.add_atom_label(*L.metal_above(m[0], m[1]), '[Fe]<sup>+</sup>')
L.eta2(s, fe, m[0], m[1]) # gestrichelte eta-2-Linie zum C=C-Mittelpunkt
L.add_h(s, m[2], deg=-90, color='red') # explizites H (optionale Farbe)
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, gibt Selbsttest aus
Koordinaten sind Punkte (1/72 Zoll), y wächst nach unten; Winkel sind Grad gegen den Uhrzeigersinn auf dem Papier (0 = rechts, 90 = oben).
Atome werden nach Position gefunden. add_bond(p1, p2) verbindet, was auch immer an p1/p2 sitzt (innerhalb von 0.6 pt), zeichnen Sie also nie ein zweites Fragment über einem vorhandenen („am Ursprung zeichnen, später verschieben“ geht schief). Zeichnen Sie jedes Teil an seiner endgültigen Position oder zeichnen Sie es in einer eigenen Scene und kopieren Sie es mit L.merge(s, teil, dx, dy) hinein; RowFigure macht dies bereits für jede Zeile. Die Bibliothek warnt, wenn ein Atom auf einem anderen landet, und save() listet Beschriftungen auf, die ohne Bindungen bleiben. Text akzeptiert <sub> <sup> <i> <b>, und HTML-Entitäten (′ ′, π π, ° °).
| Bedarf | Aufruf |
|---|---|
| Größen | L.BL = 14.4 pt (C–C-Bindung), L.ML = 21 pt (Metall–Ligand-Bindung) |
| Molekül aus SMILES | L.place(s, smi, left, cy, rotate=, flip=, labels={i: 'Ar'}, align_atom=None) → (AtomMap, Tintenbegrenzungsrahmen); cy zentriert den Tintenbegrenzungsrahmen oder setzt Atom align_atom auf Höhe cy (um eine Kette auf die Pfeilachse zu setzen). L.place_center(...); L.ink_size(smi); L.orient(smi, i, j, deg, flip=) liefert das rotate, das Bindung i→j auf deg zeigt (übergeben Sie dasselbe flip wie an place). AtomMaps sind Momentaufnahmen: Nach dem Verschieben von Atomen suchen Sie sie erneut nach. Ein Metall auf einem * erhält eine C–C-Bindungslänge; verlängern Sie sie mit L.stretch(s, m[c], m[star], L.ML). Setzen Sie Abkürzungen auf *-Atome; geben Sie Stereochemie im SMILES an, z. B. SMILES C/C=C(\*)c1ccccc1 (in einem Python-String 'C/C=C(\*)c1ccccc1'). |
| handgezeichnetes Fragment | `s.add_atom_label(x, y, text, align=None |
| Beschriftung / Bindung einfärben | s.paint(p, 'navy') (Atombeschriftung an p), s.color_bond(p1, p2, 'red', style='bold') |
| Punkt in einem Winkel | L.pol(p, deg, d=L.BL) |
| Metall auf einer π-Bindung | L.metal_above(a1, a2), L.eta2(s, metal, a1, a2) |
| explizites H | L.add_h(s, p, deg=None, color=None) (deg=None: offene Richtung) |
| Allen-Zentrumspunkt | L.allene_dot(s, p) |
| Pfeile | L.arrow_with_conditions(s, x1, y, above=[...], below=[...], eq=False), `s.add_arrow(x1, y1, x2, y2, head='full' |
| Sessel / Boot (sechsgliedriger zyklischer TS) | L.chair(center, side=L.ML, mirror=False, flip=False) → 6 Positionen in Ringreihenfolge (Sessel aus Linienzeichnung); L.boat(center, side=, mirror=, flip=) → Positionen von ChemDraws Boot-Vorlage (vordere Kante fett zeichnen, Spitze-zu-Vorderkante-Kanten als Keile; siehe Docstring). L.polygon(center, n, side=) ist nur für planare Ringe |
| Energieprofil | siehe „Energieprofile“ unten |
| Text | `s.add_text(x, y, text, align=, valign='baseline' |
| Boxen | L.fill_box(s, box_or_Mark, pad=4, fill='fill') (Kachel hinter einer Struktur), 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) |
| Farben | Palettennamen red navy grey fill rule redfill navyfill greyfill darkblue darkred (grey = #797979, darkblue #011993 und darkred #941100 sind die Pfadfarben der Liu-Gruppe); mehr mit register_color('teal', '#13786F') |
| eine Zeile pro Reaktion | `L.RowFigure(width=468, title_position='top' |
| Teile kombinieren | L.merge(s, teil, dx, dy) kopiert Szene teil in s |
| Katalysezyklus | siehe „Katalysezyklen“ unten |
| Teil verschieben / messen | mk = L.Mark(s) … zeichnen … mk.bbox(), mk.shift(dx, dy) |
| Ausgabe | L.save(s, base) → base.cdxml, base.png + Selbsttest (s.check_cdxml benötigt zuerst s.to_cdxml; save macht beides); cdxkit.chemdraw.export(cdxml, [png, cdx]) |
Metallzentren und Beschriftungen
-
Atombeschriftungen werden automatisch verankert:
- Eine Beschriftung oder ein Metallsymbol, das auf beiden Seiten gebunden ist oder drei oder mehr Bindungen hat, wird auf dem Atom zentriert (
Ar–Pd–Xmit zweiPPh3,L–Pd<sup>II</sup>–L); - eine Beschriftung, deren Bindung von rechts kommt, wird rechtsbündig ausgerichtet (
Fp–CH2,TIPSO–); - andernfalls wird sie linksbündig ausgerichtet, sodass das erste Zeichen auf dem Atom sitzt (
PPh3über oder unter einem Metall).
Überschreiben Sie dies mit
align='left'|'right'|'center'. Eine Beschriftung kann nicht an einem Zeichen in ihrer Mitte verankert werden (z. B. das Fe vonCp*Fe(CO)2); schreiben Sie sie so, dass das gebundene Atom zuerst oder zuletzt kommt. - Eine Beschriftung oder ein Metallsymbol, das auf beiden Seiten gebunden ist oder drei oder mehr Bindungen hat, wird auf dem Atom zentriert (
-
Verwenden Sie
L.MLfür Metall–Ligand-Bindungen. Wenn zwei Beschriftungen so nahe kommen, dass die Bindung zwischen ihnen verschwinden würde, warntsave().
Katalysezyklen
cyc = Cycle(s, cx, cy, r, clockwise=True, hook_radius=17, hook_sweep=72)
cyc.arc(62, 16) # Bogenpfeil, Kopf bei 16 Grad (im Uhrzeigersinn)
cyc.hook(54, 'in', 'base') # Reagenz tritt bei 54 Grad bei
cyc.hook(34, 'out', 'BH<sup>+</sup>') # Nebenprodukt verlässt bei 34 Grad
cyc.hook(148, 'in', draw_fn) # draw_fn(scene, (x, y)): eine Struktur
cyc.label(26, 'Deprotonierung', dist=8, color='navy') # Schrittname innen, neben seinem Bogen
- Ein Haken berührt den Zyklus bei
thetaund krümmt sich nach außen. Bei einem Zyklus im Uhrzeigersinn liegt das freie Ende eines'in'-Hakens stromaufwärts (gegen den Uhrzeigersinn von theta) und das eines'out'-Hakens stromabwärts. Wählen Sie theta so, dass das freie Ende in leerem Raum landet. - Die Beschriftung oder Struktur geht über das freie Ende hinaus: zu seiner Rechten auf der rechten Hälfte des Zyklus, zu seiner Linken auf der linken Hälfte, oben und unten zentriert. Erzwingen Sie eine Seite mit
side='left'|'right'|'center';gap=legt den Abstand fest;head_in='full'setzt einen Kopf auf einen 'in'-Haken. cyc.labelakzeptiert mehrzeiligen Text ('reduktive Eliminierung') und hält breiten Text oben und unten frei vom Bogen. Erhöhen Siedist, wenn er ihn immer noch berührt.- Typische Größen mit 10-pt-Text: r = 55–65 pt.
Energieprofile
from cdxkit.energy import EnergyProfile, load_energies, common_sides
E = load_energies('energies.csv', column='M06/def2-TZVP') # {label: kcal/mol}, siehe unten
ep = EnergyProfile(energies=E) # Liu-Gruppe-Standardeinstellungen; bars='bonds' optional
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']) # beginnt bei einem bekannten Label = verzweigt dort
ep.structure('TS1', draw_ts1) # draw_ts1(scene) zeichnet den TS irgendwo
# ep.note('M06/def2-TZVP/SMD(DCE)//B3LYP-D3(BJ)/6-31G(d)') # nur, wenn der Benutzer danach fragt
ep.save('out/profile') # .cdxml + .png + Prüfungen + Wertetabelle
- Zahlen. Nehmen Sie sie aus der Tabelle des Benutzers, niemals aus dem Gedächtnis oder aus einer alten Abbildung.
- Die CSV hat das Label in der ersten Spalte und eine Spalte pro Methode, in kcal/mol relativ zu einer Referenz. Spalten, deren Überschrift mit
#beginnt, sind Notizen; eine leere Zelle oder n.a. bedeutet keinen Wert. - Ein Schritt, der nur durch sein Label gegeben ist, wird in dieser Tabelle nachgeschlagen.
('TS1', 12.4)gibt den Wert direkt an; verwenden Sie dies nur, wenn es keine Tabelle gibt. - Dasselbe Label in zwei Pfaden ist ein Punkt. Es muss in beiden die gleiche Energie haben; geben Sie verschiedenen Spezies unterschiedliche Label.
- Die CSV hat das Label in der ersten Spalte und eine Spalte pro Methode, in kcal/mol relativ zu einer Referenz. Spalten, deren Überschrift mit
- Schrittoptionen (am Schritt, als dict):
add=,remove=: ein eintretendes Reagenz oder ein austretendes Produkt auf dem Verbinder zum nächsten Schritt;at=,curve='above'|'below': wo auf diesem Verbinder die Kurve berührt (0 bis 1) und auf welcher Seite des Verbinders die Kurve verläuft. Wenn eines ausgelassen wird, versucht die Bibliothek Positionen und beide Seiten, bis die Kurve und ihre Texte nichts berühren;shift=: ein Skalenbruch auf dem Verbinder i
… [für die Übersetzung gekürzt]