CommunityImagegithub.com

chemdraw-figures

Dessiner des figures de chimie (schémas réactionnels, séries de réactions de la littérature, cycles catalytiques, complexes métal-π, profils d'énergie réactionnelle à partir d'énergies DFT, structures d'état de transition) sous forme de CDXML modifiable dans ChemDraw et d'un PNG, en utilisant la bibliothèque Python cdxkit de ce dossier.

Qu'est-ce que chemdraw-figures ?

Cette compétence permet de générer des figures chimiques prêtes à être éditées dans ChemDraw (format CDXML) et exportées en PNG haute résolution (600 dpi) via la bibliothèque Python `cdxkit`. Elle prend en charge les schémas réactionnels, les cycles catalytiques, les complexes métal–π, les profils d'énergie DFT et les états de transition. L'utilisateur peut demander explicitement un style prédéfini (`acs-plain`, `literature-rows`, `liu-group`) ou en choisir un ; en l'absence de style spécifié, un choix unique est proposé avant le dessin. La compétence valide automatiquement le CDXML via un auto-test et génère un PNG visuellement fidèle à ce que produirait ChemDraw. Elle est conçue pour les workflows de chimie computationnelle et de publication, en particulier pour les groupes de recherche utilisant des standards graphiques comme ceux du groupe Liu.

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

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

ChemDraw figures avec cdxkit

cdxkit transforme une courte description Python d'une figure en deux fichiers : un CDXML qui s'ouvre dans ChemDraw et reste entièrement modifiable, et un PNG rendu pour ressembler à ChemDraw (600 dpi). La bibliothèque se trouve dans cdxkit/ à côté de ce fichier ; les exemples dans examples/ sont le moyen le plus rapide de voir comment une figure est construite.

1. Définir d'abord le contenu et le style

  • Contenu. Quelles réactions, structures, conditions et chiffres entrent, et d'où chacun provient (un article, le propre fichier ChemDraw de l'utilisateur, ses notes). Si quelque chose manque, demandez ; ne remplissez jamais un rendement, une condition ou une structure de mémoire.
  • Style. Les styles se trouvent dans styles/. Utilisez-en un uniquement lorsque l'utilisateur le demande par son nom (ou dit par exemple « like Chapter 1 », « 第 1 章那种风格 » → styles/literature-rows.md). Si l'utilisateur n'a pas nommé de style, demandez une fois, en proposant :
    • acs-plain : les paramètres par défaut d'ACS Document 1996, noir uniquement (styles/acs-plain.md) ;
    • literature-rows : une réaction de la littérature par ligne, quelques couleurs avec des significations fixes, flèches incurvées entrant/sortant sur les cycles (styles/literature-rows.md) ;
    • liu-group : figures computationnelles, c'est-à-dire profils d'énergie, états de transition et intermédiaires, suivant les SOP du groupe Liu (styles/liu-group.md ; aussi « 刘组风格 ») ;
    • faire correspondre une figure ou une spécification fournie par l'utilisateur. N'appliquez pas de couleurs ou de conventions de mise en page d'un style que l'utilisateur n'a pas choisi. Pour un profil d'énergie sans style nommé, proposez liu-group en premier : c'est le seul style avec des règles pour les profils.

2. Règles qui s'appliquent dans tous les styles

  1. Fidèle à la source. Dessinez chaque structure comme la source la dessine : même orientation, même stéréochimie (ne miroitez pas et ne retournez pas un produit « pour l'adapter » ; un dessin retourné suggère un stéréoisomère différent). Copiez exactement les conditions et les chiffres, et dites ce qu'est un chiffre (rendement isolé vs RMN, r.d., ee). Si la source n'est pas disponible, dites-le plutôt que de deviner.

  2. Cohérent dans une figure. Le même type d'élément est dessiné de la même manière partout dans une figure (ne montrez pas un composé comme une structure et un autre comme une formule condensée ; même abréviation, même longueur de liaison, même style d'étiquette).

  3. Les étiquettes se lisent correctement. Une étiquette est écrite de sorte que l'atome lié touche la liaison :

    • liaison depuis la droite → OTIPS devient TIPSO ;
    • liaison depuis la gauche → commencez par l'atome lié, ex. Fe(CO)<sub>2</sub>Cp* ;
    • liaison depuis le dessus ou le dessous → commencez par l'atome lié et alignez-le à gauche, ex. ('OBBu<sub>2</sub>', 'left').

    Écrivez les étiquettes telles qu'elles doivent apparaître. Dans le CDXML, cdxkit stocke une étiquette qui se trouve à gauche de sa liaison dans l'ordre tapé de ChemDraw (TIPSO est stocké comme OTIPS), car ChemDraw lit les étiquettes de cette façon lorsqu'il ouvre ou enregistre un fichier. N'inversez pas les étiquettes vous-même.

  4. Regardez-la. Rendez toujours le PNG et visualisez-le avant de le montrer à l'utilisateur. Vérifiez : les étiquettes inversées ou mal placées, le texte qui se chevauche, les flèches qui n'atteignent pas, les conditions encombrées, les lignes non centrées, l'espace vide sur un côté.

  5. Vérifiez le fichier. layout.save() affiche name: self-check PASS plus toutes les lignes WARNING:.

    • PASS signifie que le CDXML est relu par RDKit avec les mêmes nœuds, liaisons et squelette organique (les fragments constitués uniquement d'étiquettes telles que [Fe], L, Ar sont vérifiés uniquement pour les comptages). Cela ne dit rien sur l'apparence du PNG.
    • Deux avertissements concernent les liaisons coincées entre des étiquettes ; dans les deux cas, allongez la liaison (L.ML pour les liaisons métalliques) ou déplacez les étiquettes :
      • « bond X-Y … is hidden by its labels » : la liaison est absente du PNG (elle est toujours dans le CDXML) ;
      • « bond X-Y … shows only n pt between its labels » : la liaison est trop courte pour être lue. Une liaison pointillée TS plus courte qu'environ 4 pt semble solide.
    • Sur Windows avec ChemDraw installé, cdxkit.chemdraw.export() ouvre le CDXML dans ChemDraw et enregistre un PNG/CDX rendu par ChemDraw. Il refuse de s'exécuter pendant que ChemDraw est déjà ouvert (l'utilisateur peut avoir un travail non enregistré) et ne quitte jamais un ChemDraw qu'il n'a pas démarré.
  6. Remettez le .cdxml (pour édition dans ChemDraw) et le .png, et listez tout ce que l'utilisateur doit encore ajuster à la main (voir Limitations).

3. Utiliser la bibliothèque

import sys; sys.path.insert(0, r'<ce dossier de compétence>')
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, liaison 14.4 pt
m, box = L.place(s, 'C=CCC', 10, 60)          # SMILES -> atomes ; box = boîte d'encre
fe = s.add_atom_label(*L.metal_above(m[0], m[1]), '[Fe]<sup>+</sup>')
L.eta2(s, fe, m[0], m[1])                     # ligne pointillée eta-2 vers le milieu de C=C
L.add_h(s, m[2], deg=-90, color='red')        # H explicite (couleur facultative)
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, affiche l'auto-test

Les coordonnées sont en points (1/72 po), y croît vers le bas ; les angles sont en degrés dans le sens inverse des aiguilles d'une montre sur le papier (0 = droite, 90 = haut).

Les atomes sont trouvés par position. add_bond(p1, p2) connecte tout atome situé à p1/p2 (à moins de 0.6 pt), donc ne dessinez jamais un deuxième fragment par-dessus un existant (« dessiner à l'origine, déplacer ensuite » échoue). Dessinez chaque partie à sa position finale, ou dessinez-la dans sa propre Scene et copiez-la avec L.merge(s, part, dx, dy) ; RowFigure fait déjà cela pour chaque ligne. La bibliothèque avertit lorsqu'un atome atterrit sur un autre, et save() liste les étiquettes laissées sans liaisons. Le texte accepte <sub> <sup> <i> <b>, \n, et les entités HTML (&#8242; ′, &#960; π, &#176; °).

BesoinAppel
taillesL.BL = 14.4 pt (liaison C–C), L.ML = 21 pt (liaison métal–ligand)
molécule depuis SMILESL.place(s, smi, left, cy, rotate=, flip=, labels={i: 'Ar'}, align_atom=None) → (AtomMap, boîte d'encre) ; cy centre la boîte d'encre, ou place l'atome align_atom à la hauteur cy (pour placer une chaîne sur l'axe de la flèche). L.place_center(...) ; L.ink_size(smi) ; L.orient(smi, i, j, deg, flip=) donne le rotate qui pointe la liaison i→j vers deg (passez le même flip qu'à place). Les AtomMaps sont des instantanés : après avoir déplacé des atomes, recherchez-les à nouveau. Un métal sur un * obtient une liaison de longueur C–C ; allongez-la avec L.stretch(s, m[c], m[star], L.ML). Mettez les abréviations sur les atomes * ; donnez la stéréochimie dans le SMILES, par ex. SMILES C/C=C(\*)c1ccccc1 (dans une chaîne Python 'C/C=C(\\*)c1ccccc1').
fragment dessiné à la main`s.add_atom_label(x, y, text, align=None
colorer une étiquette / liaisons.paint(p, 'navy') (étiquette d'atome à p), s.color_bond(p1, p2, 'red', style='bold')
point à un angleL.pol(p, deg, d=L.BL)
métal sur une liaison πL.metal_above(a1, a2), L.eta2(s, metal, a1, a2)
H expliciteL.add_h(s, p, deg=None, color=None) (deg=None : direction ouverte)
point central d'allèneL.allene_dot(s, p)
flèchesL.arrow_with_conditions(s, x1, y, above=[...], below=[...], eq=False), `s.add_arrow(x1, y1, x2, y2, head='full'
chaise / bateau (TS cyclique à six chaînons)L.chair(center, side=L.ML, mirror=False, flip=False) → 6 positions dans l'ordre du cycle (chaise de manuel en ligne simple) ; L.boat(center, side=, mirror=, flip=) → positions du modèle de bateau de ChemDraw (dessiner le bord avant en gras, les bords pointe-avant en coins ; voir docstring). L.polygon(center, n, side=) est uniquement pour les cycles plans
profil d'énergievoir « Profils d'énergie » ci-dessous
texte`s.add_text(x, y, text, align=, valign='baseline'
boîtesL.fill_box(s, box_or_Mark, pad=4, fill='fill') (tuile derrière une structure), 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)
couleursnoms de palette red navy grey fill rule redfill navyfill greyfill darkblue darkred (grey = #797979, darkblue #011993 et darkred #941100 sont les couleurs de voie du groupe liu) ; plus avec register_color('teal', '#13786F')
une ligne par réaction`L.RowFigure(width=468, title_position='top'
combiner des piècesL.merge(s, part, dx, dy) copie la scène part dans s
cycle catalytiquevoir « Cycles catalytiques » ci-dessous
déplacer / mesurer une partiemk = L.Mark(s) … dessiner … mk.bbox(), mk.shift(dx, dy)
sortieL.save(s, base) → base.cdxml, base.png + auto-test (s.check_cdxml nécessite d'abord s.to_cdxml ; save fait les deux) ; cdxkit.chemdraw.export(cdxml, [png, cdx])

Centres métalliques et étiquettes

  • Les étiquettes d'atomes sont ancrées automatiquement :

    • une étiquette ou un symbole métallique lié des deux côtés, ou avec trois liaisons ou plus, est centré sur l'atome (Ar–Pd–X avec deux PPh3, L–Pd<sup>II</sup>–L) ;
    • une étiquette dont la liaison vient de la droite est alignée à droite (Fp–CH2, TIPSO–) ;
    • sinon, elle est alignée à gauche, de sorte que le premier caractère repose sur l'atome (PPh3 au-dessus ou en dessous d'un métal).

    Remplacez avec align='left'|'right'|'center'. Une étiquette ne peut pas être ancrée sur un caractère en son milieu (par ex. le Fe de Cp*Fe(CO)2) ; écrivez-la de sorte que l'atome lié vienne en premier ou en dernier.

  • Utilisez L.ML pour les liaisons métal–ligand. Si deux étiquettes sont si proches que la liaison entre elles disparaîtrait, save() avertit.

Cycles catalytiques

cyc = Cycle(s, cx, cy, r, clockwise=True, hook_radius=17, hook_sweep=72)
cyc.arc(62, 16)                                     # flèche d'arc, tête à 16 deg (sens horaire)
cyc.hook(54, 'in', 'base')                          # réactif rejoint à 54 deg
cyc.hook(34, 'out', 'BH<sup>+</sup>')               # sous-produit part à 34 deg
cyc.hook(148, 'in', draw_fn)                        # draw_fn(scene, (x, y)) : une structure
cyc.label(26, 'deprotonation', dist=8, color='navy')   # nom d'étape à l'intérieur, à côté de son arc
  • Un crochet touche le cycle à theta et se recourbe vers l'extérieur. Pour un cycle horaire, l'extrémité libre d'un crochet 'in' se trouve en amont (anti-horaire de theta) et celle d'un crochet 'out' se trouve en aval. Choisissez theta pour que l'extrémité libre atterrisse dans un espace vide.
  • L'étiquette ou la structure va au-delà de l'extrémité libre : à sa droite sur la moitié droite du cycle, à sa gauche sur la moitié gauche, centrée près du haut et du bas. Forcez un côté avec side='left'|'right'|'center' ; gap= définit la distance ; head_in='full' met une tête sur un crochet 'in'.
  • cyc.label accepte le texte multiligne ('reductive\nelimination') et maintient le texte large près du haut et du bas dégagé de l'arc. Augmentez dist s'il touche encore.
  • Tailles typiques avec texte 10 pt : r = 55–65 pt.

Profils d'énergie

from cdxkit.energy import EnergyProfile, load_energies, common_sides
E = load_energies('energies.csv', column='M06/def2-TZVP')   # {label: kcal/mol}, voir ci-dessous
ep = EnergyProfile(energies=E)                  # paramètres par défaut du groupe liu ; bars='bonds' facultatif
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'])                    # commence à un label connu = y branche
ep.structure('TS1', draw_ts1)                   # draw_ts1(scene) dessine le TS n'importe où
# ep.note('M06/def2-TZVP/SMD(DCE)//B3LYP-D3(BJ)/6-31G(d)')  # seulement si l'utilisateur le demande
ep.save('out/profile')                          # .cdxml + .png + vérifications + tableau des valeurs
  • Chiffres. Prenez-les dans le tableau de l'utilisateur, jamais de mémoire ou d'une ancienne figure.
    • Le CSV a le label dans la première colonne et une colonne par méthode, en kcal/mol par rapport à une référence. Les colonnes dont l'en-tête commence par # sont des notes ; une cellule vide ou n.a. signifie aucune valeur.
    • Une étape donnée uniquement par son label est recherchée dans ce tableau. ('TS1', 12.4) donne directement la valeur ; utilisez-le uniquement lorsqu'il n'y a pas de tableau.
    • Le même label dans deux chemins est un point. Il doit avoir la même énergie dans les deux ; donnez des labels différents à des espèces différentes.
  • Options d'étape (sur l'étape, sous forme de dict) :
    • add=, remove= : un réactif entrant ou un produit partant sur le connecteur vers l'étape suivante ;
    • at=, curve='above'|'below' : où sur ce connecteur la courbe touche (0 à 1), et de quel côté de celui-ci la courbe va. Si l'un ou l'autre est omis, la bibliothèque essaie des positions et les deux côtés jusqu'à ce que la courbe et ses textes ne touchent rien ;
    • shift= : une rupture d'échelle sur le connecteur i

…

[section tronquée pour la traduction]

Skills associés