CommunityBildgithub.com

chemdraw-figures

Zeichnen Sie chemische Abbildungen (Reaktionsschemata, Literaturreaktionsreihen, Katalysezyklen, Metall-π-Komplexe, Reaktionsenergieprofile aus DFT-Energien, Übergangszustandsstrukturen) als bearbeitbares ChemDraw-CDXML plus PNG unter Verwendung der cdxkit-Python-Bibliothek. Verwenden Sie dies, wenn der Benutzer darum bittet, eine ChemDraw-Abbildung, ein Schema, einen Katalysezyklus oder ein Energieprofil zu zeichnen, neu zu zeichnen oder aufzuräumen (auch auf Chinesisch, z. B. „画 ChemDraw 图

Was ist chemdraw-figures?

Diese KI-Fertigkeit ermöglicht das präzise Zeichnen chemischer Abbildungen als vollständig editierbare ChemDraw-Dateien (CDXML) und hochauflösende PNG-Dateien (600 dpi). Die cdxkit-Bibliothek wandelt eine kurze Python-Beschreibung der Abbildung in die Ausgabeformate um, sodass ChemLaborexperten Reaktionsschemata, Katalysezyklen und Energieprofile aus DFT-Daten erstellen können, ohne die Zeichnung manuell erstellen zu müssen. Die Fertigkeit unterstützt mehrere Darstellungsstile (acs-plain, literature-rows, liu-group), die in speziell gekennzeichneten Dateien definiert sind. Sie wendet einen Stil nur an, wenn der Benutzer ihn explizit angibt (z. B. „wie Kapitel 1“ oder „Stil der Liu-Gruppe“); andernfalls fordert sie einmal zur Auswahl auf. Ein eingebauter Selbsttest überprüft die Datei auf häufige Probleme wie überlappende Etiketten, versteckte Bindungen oder Formatierungsinkonsistenzen und gibt eine Bestanden/Warnung-Bewertung aus. Die Fertigkeit umfasst spezielle Hilfsprogramme für Katalysezyklen, Energieprofile und die Handhabung formatierten Texts (tiefgestellt, hochgestellt, kursiv) und stellt sicher, dass Abbildungen änderbar bleiben und den ChemDraw-Standardformatierungskonventionen entsprechen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ruiqi-Ding-chem/chemdraw-figure-kit/tree/HEAD

Installed? Explore more Bild skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

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

  1. 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.

  2. 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).

  3. Beschriftungen korrekt lesen. Eine Beschriftung wird so geschrieben, dass das gebundene Atom die Bindung berührt:

    • Bindung von rechts → OTIPS wird zu TIPSO;
    • 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 (TIPSO wird als OTIPS gespeichert), weil ChemDraw Beschriftungen beim Öffnen oder Speichern einer Datei so liest. Kehren Sie Beschriftungen nicht selbst um.

  4. 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.

  5. Datei prüfen. layout.save() gibt name: self-check PASS plus eventuelle WARNING:-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, Ar bestehen, 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.ML fü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.
  6. Ü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 (&#8242; ′, &#960; π, &#176; °).

BedarfAufruf
GrößenL.BL = 14.4 pt (C–C-Bindung), L.ML = 21 pt (Metall–Ligand-Bindung)
Molekül aus SMILESL.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ärbens.paint(p, 'navy') (Atombeschriftung an p), s.color_bond(p1, p2, 'red', style='bold')
Punkt in einem WinkelL.pol(p, deg, d=L.BL)
Metall auf einer π-BindungL.metal_above(a1, a2), L.eta2(s, metal, a1, a2)
explizites HL.add_h(s, p, deg=None, color=None) (deg=None: offene Richtung)
Allen-ZentrumspunktL.allene_dot(s, p)
PfeileL.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
Energieprofilsiehe „Energieprofile“ unten
Text`s.add_text(x, y, text, align=, valign='baseline'
BoxenL.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)
FarbenPalettennamen 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 kombinierenL.merge(s, teil, dx, dy) kopiert Szene teil in s
Katalysezyklussiehe „Katalysezyklen“ unten
Teil verschieben / messenmk = L.Mark(s) … zeichnen … mk.bbox(), mk.shift(dx, dy)
AusgabeL.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–X mit zwei PPh3, 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 von Cp*Fe(CO)2); schreiben Sie sie so, dass das gebundene Atom zuerst oder zuletzt kommt.

  • Verwenden Sie L.ML für Metall–Ligand-Bindungen. Wenn zwei Beschriftungen so nahe kommen, dass die Bindung zwischen ihnen verschwinden würde, warnt save().

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 theta und 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.label akzeptiert mehrzeiligen Text ('reduktive Eliminierung') und hält breiten Text oben und unten frei vom Bogen. Erhöhen Sie dist, 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.
  • 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]

Verwandte Skills