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
-
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.
-
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).
-
Les étiquettes se lisent correctement. Une étiquette est écrite de sorte que l'atome lié touche la liaison :
- liaison depuis la droite →
OTIPSdevientTIPSO; - 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 (
TIPSOest stocké commeOTIPS), car ChemDraw lit les étiquettes de cette façon lorsqu'il ouvre ou enregistre un fichier. N'inversez pas les étiquettes vous-même. - liaison depuis la droite →
-
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é.
-
Vérifiez le fichier.
layout.save()affichename: self-check PASSplus toutes les lignesWARNING:.- 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,Arsont 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.MLpour 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é.
- 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
-
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 (′ ′, π π, ° °).
| Besoin | Appel |
|---|---|
| tailles | L.BL = 14.4 pt (liaison C–C), L.ML = 21 pt (liaison métal–ligand) |
| molécule depuis SMILES | L.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 / liaison | s.paint(p, 'navy') (étiquette d'atome à p), s.color_bond(p1, p2, 'red', style='bold') |
| point à un angle | L.pol(p, deg, d=L.BL) |
| métal sur une liaison π | L.metal_above(a1, a2), L.eta2(s, metal, a1, a2) |
| H explicite | L.add_h(s, p, deg=None, color=None) (deg=None : direction ouverte) |
| point central d'allène | L.allene_dot(s, p) |
| flèches | L.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'énergie | voir « Profils d'énergie » ci-dessous |
| texte | `s.add_text(x, y, text, align=, valign='baseline' |
| boîtes | L.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) |
| couleurs | noms 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èces | L.merge(s, part, dx, dy) copie la scène part dans s |
| cycle catalytique | voir « Cycles catalytiques » ci-dessous |
| déplacer / mesurer une partie | mk = L.Mark(s) … dessiner … mk.bbox(), mk.shift(dx, dy) |
| sortie | L.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–Xavec deuxPPh3,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 (
PPh3au-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 deCp*Fe(CO)2) ; écrivez-la de sorte que l'atome lié vienne en premier ou en dernier. - une étiquette ou un symbole métallique lié des deux côtés, ou avec trois liaisons ou plus, est centré sur l'atome (
-
Utilisez
L.MLpour 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 à
thetaet 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.labelaccepte le texte multiligne ('reductive\nelimination') et maintient le texte large près du haut et du bas dégagé de l'arc. Augmentezdists'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.
- 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
- 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]