Figuras ChemDraw con cdxkit
cdxkit convierte una breve descripción en Python de una figura en dos archivos: un CDXML que se abre en ChemDraw y permanece completamente editable, y un PNG renderizado con apariencia de ChemDraw (600 dpi). La biblioteca está en cdxkit/ junto a este archivo; los ejemplos en examples/ son la forma más rápida de ver cómo se construye una figura.
1. Definir primero el contenido y el estilo
- Contenido. Qué reacciones, estructuras, condiciones y números van, y de dónde proviene cada uno (un artículo, el propio archivo ChemDraw del usuario, sus notas). Si falta algo, pregunta; nunca inventes un rendimiento, condición o estructura de memoria.
- Estilo. Los estilos están en
styles/. Usa uno solo cuando el usuario lo solicite por su nombre (o diga, por ejemplo, "como el Capítulo 1", "第 1 章那种风格" →styles/literature-rows.md). Si el usuario no nombró un estilo, pregunta una vez, ofreciendo:acs-plain: valores predeterminados de ChemDraw ACS Document 1996, solo en negro (styles/acs-plain.md);literature-rows: una reacción de la literatura por fila, algunos colores con significados fijos, flechas curvas de entrada/salida en ciclos (styles/literature-rows.md);liu-group: figuras computacionales, es decir, perfiles de energía, estados de transición e intermedios, siguiendo los SOP del grupo Liu (styles/liu-group.md; también "刘组风格");- hacer coincidir una figura o especificación que el usuario proporcione. No apliques colores o convenciones de diseño de un estilo que el usuario no eligió. Para un perfil de energía sin estilo nombrado, ofrece liu-group primero: es el único estilo con reglas para perfiles.
2. Reglas que se aplican en todos los estilos
-
Fiel a la fuente. Dibuja cada estructura como la dibuja la fuente: misma orientación, misma estereoquímica (no reflejes ni voltees un producto "para que encaje"; un dibujo volteado sugiere un estereoisómero diferente). Copia las condiciones y los números exactamente, y di qué representa un número (rendimiento aislado vs. RMN, r.d., ee). Si la fuente no está disponible, dilo en lugar de adivinar.
-
Consistente dentro de una figura. El mismo tipo de cosa se dibuja de la misma manera en todas partes de una figura (no muestres un compuesto como estructura y otro como fórmula condensada; misma abreviatura, misma longitud de enlace, mismo estilo de etiqueta).
-
Las etiquetas se leen correctamente. Una etiqueta se escribe de modo que el átomo enlazado toque el enlace:
- enlace desde la derecha →
OTIPSse convierte enTIPSO; - enlace desde la izquierda → comienza con el átomo enlazado, por ejemplo,
Fe(CO)<sub>2</sub>Cp*; - enlace desde arriba o abajo → comienza con el átomo enlazado y alinéalo a la izquierda, por ejemplo,
('OBBu<sub>2</sub>', 'left').
Escribe las etiquetas como deben aparecer. En el CDXML, cdxkit almacena una etiqueta que se encuentra a la izquierda de su enlace en el orden escrito de ChemDraw (
TIPSOse almacena comoOTIPS), porque ChemDraw lee las etiquetas de esa manera cuando abre o guarda un archivo. No inviertas las etiquetas tú mismo. - enlace desde la derecha →
-
Míralo. Siempre renderiza el PNG y revísalo antes de mostrárselo al usuario. Verifica: etiquetas invertidas o mal colocadas, texto superpuesto, flechas que no alcanzan, condiciones abarrotadas, filas que no están centradas, espacio vacío en un lado.
-
Verifica el archivo.
layout.save()imprimename: self-check PASSmás cualquier líneaWARNING:.- PASS significa que el CDXML se lee de vuelta con RDKit con los mismos nodos, enlaces y esqueleto orgánico (los fragmentos hechos solo de etiquetas como
[Fe],L,Arse verifican solo por recuento). No dice nada sobre cómo se ve el PNG. - Dos advertencias se refieren a enlaces apretados entre etiquetas; en ambos casos, alarga el enlace (
L.MLpara enlaces metálicos) o mueve las etiquetas:- "bond X-Y … is hidden by its labels": el enlace falta en el PNG (todavía está en el CDXML);
- "bond X-Y … shows only n pt between its labels": el enlace es demasiado corto para leerse. Un enlace TS discontinuo más corto de aproximadamente 4 pt parece sólido.
- En Windows con ChemDraw instalado,
cdxkit.chemdraw.export()abre el CDXML en ChemDraw y guarda un PNG/CDX renderizado por ChemDraw. Se niega a ejecutarse mientras ChemDraw ya está abierto (el usuario puede tener trabajo no guardado) y nunca cierra un ChemDraw que no inició.
- PASS significa que el CDXML se lee de vuelta con RDKit con los mismos nodos, enlaces y esqueleto orgánico (los fragmentos hechos solo de etiquetas como
-
Entrega el
.cdxml(para editar en ChemDraw) y el.png, y enumera cualquier cosa que el usuario deba ajustar manualmente (ver Limitaciones).
3. Uso de la biblioteca
import sys; sys.path.insert(0, r'<carpeta de esta habilidad>')
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, enlace 14.4 pt
m, box = L.place(s, 'C=CCC', 10, 60) # SMILES -> átomos; box = cuadro delimitador de tinta
fe = s.add_atom_label(*L.metal_above(m[0], m[1]), '[Fe]<sup>+</sup>')
L.eta2(s, fe, m[0], m[1]) # línea eta-2 discontinua al punto medio del C=C
L.add_h(s, m[2], deg=-90, color='red') # H explícito (color opcional)
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, imprime autocomprobación
Las coordenadas son puntos (1/72 pulgada), y crece hacia abajo; los ángulos son grados en sentido antihorario en el papel (0 = derecha, 90 = arriba).
Los átomos se encuentran por posición. add_bond(p1, p2) conecta cualquier átomo que esté en p1/p2 (dentro de 0.6 pt), por lo que nunca dibujes un segundo fragmento sobre uno existente ("dibujar en el origen, mover después" sale mal). Dibuja cada parte en su posición final, o dibújala en su propio Scene y cópiala con L.merge(s, part, dx, dy); RowFigure ya hace esto para cada fila. La biblioteca advierte cuando un átomo cae sobre otro, y save() enumera las etiquetas que quedan sin enlaces. El texto acepta <sub> <sup> <i> <b>, \n, y entidades HTML (′ ′, π π, ° °).
| Necesidad | Llamada |
|---|---|
| tamaños | L.BL = 14.4 pt (enlace C–C), L.ML = 21 pt (enlace metal–ligando) |
| molécula desde SMILES | L.place(s, smi, left, cy, rotate=, flip=, labels={i: 'Ar'}, align_atom=None) → (AtomMap, cuadro delimitador de tinta); cy centra el cuadro delimitador, o coloca el átomo align_atom a la altura cy (para colocar una cadena en el eje de la flecha). L.place_center(...); L.ink_size(smi); L.orient(smi, i, j, deg, flip=) da la rotate que apunta el enlace i→j a deg (pasa el mismo flip que a place). Los AtomMaps son instantáneas: después de mover átomos, búscalos de nuevo. Un metal en un * obtiene un enlace de longitud C–C; alárgalo con L.stretch(s, m[c], m[star], L.ML). Pon abreviaturas en átomos *; da la estereoquímica en el SMILES, por ejemplo, SMILES C/C=C(\*)c1ccccc1 (en una cadena de Python 'C/C=C(\\*)c1ccccc1'). |
| fragmento dibujado a mano | `s.add_atom_label(x, y, text, align=None |
| colorear una etiqueta / enlace | s.paint(p, 'navy') (etiqueta de átomo en p), s.color_bond(p1, p2, 'red', style='bold') |
| punto en un ángulo | L.pol(p, deg, d=L.BL) |
| metal en un enlace π | L.metal_above(a1, a2), L.eta2(s, metal, a1, a2) |
| H explícito | L.add_h(s, p, deg=None, color=None) (deg=None: dirección abierta) |
| punto central de aleno | L.allene_dot(s, p) |
| flechas | L.arrow_with_conditions(s, x1, y, above=[...], below=[...], eq=False), `s.add_arrow(x1, y1, x2, y2, head='full' |
| silla / bote (TS cíclico de seis miembros) | L.chair(center, side=L.ML, mirror=False, flip=False) → 6 posiciones en orden de anillo (silla de libro de texto de línea simple); L.boat(center, side=, mirror=, flip=) → posiciones de la plantilla de bote de ChemDraw (dibujar el borde frontal en negrita, los bordes de punta a frente como cuñas; ver cadena de documentación). L.polygon(center, n, side=) es solo para anillos planos |
| perfil de energía | ver "Perfiles de energía" a continuación |
| texto | `s.add_text(x, y, text, align=, valign='baseline' |
| cuadros | L.fill_box(s, box_or_Mark, pad=4, fill='fill') (mosaico detrás de una estructura), 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) |
| colores | nombres de paleta red navy grey fill rule redfill navyfill greyfill darkblue darkred (grey = #797979, darkblue #011993 y darkred #941100 son los colores de ruta de liu-group); más con register_color('teal', '#13786F') |
| una fila por reacción | `L.RowFigure(width=468, title_position='top' |
| combinar piezas | L.merge(s, part, dx, dy) copia la escena part en s |
| mover / medir una parte | mk = L.Mark(s) … dibujar … mk.bbox(), mk.shift(dx, dy) |
| salida | L.save(s, base) → base.cdxml, base.png + autocomprobación (s.check_cdxml necesita s.to_cdxml primero; save hace ambos); cdxkit.chemdraw.export(cdxml, [png, cdx]) |
Centros metálicos y etiquetas
-
Las etiquetas de los átomos se anclan automáticamente:
- una etiqueta o símbolo metálico enlazado por ambos lados, o con tres o más enlaces, se centra en el átomo (
Ar–Pd–Xcon dosPPh3,L–Pd<sup>II</sup>–L); - una etiqueta cuyo enlace proviene de la derecha se alinea a la derecha (
Fp–CH2,TIPSO–); - de lo contrario, se alinea a la izquierda, por lo que el primer carácter se sienta en el átomo (
PPh3arriba o abajo de un metal).
Anula con
align='left'|'right'|'center'. Una etiqueta no puede anclarse en un carácter en su medio (por ejemplo, el Fe deCp*Fe(CO)2); escríbela de modo que el átomo enlazado venga primero o último. - una etiqueta o símbolo metálico enlazado por ambos lados, o con tres o más enlaces, se centra en el átomo (
-
Usa
L.MLpara enlaces metal–ligando. Si dos etiquetas terminan tan cerca que el enlace entre ellas desaparecería,save()advierte.
Ciclos catalíticos
cyc = Cycle(s, cx, cy, r, clockwise=True, hook_radius=17, hook_sweep=72)
cyc.arc(62, 16) # flecha de arco, cabeza a 16 grados (sentido horario)
cyc.hook(54, 'in', 'base') # reactivo se une a 54 grados
cyc.hook(34, 'out', 'BH<sup>+</sup>') # subproducto sale a 34 grados
cyc.hook(148, 'in', draw_fn) # draw_fn(scene, (x, y)): una estructura
cyc.label(26, 'deprotonation', dist=8, color='navy') # nombre del paso dentro, junto a su arco
- Un gancho toca el ciclo en
thetay se curva hacia afuera. Para un ciclo en sentido horario, el extremo libre de un gancho'in'se encuentra aguas arriba (en sentido antihorario de theta) y el de un gancho'out'se encuentra aguas abajo. Elige theta para que el extremo libre aterrice en el espacio vacío. - La etiqueta o estructura va más allá del extremo libre: a su derecha en la mitad derecha del ciclo, a su izquierda en la mitad izquierda, centrada cerca de la parte superior e inferior. Fuerza un lado con
side='left'|'right'|'center';gap=establece la distancia;head_in='full'pone una cabeza en un gancho 'in'. cyc.labelacepta texto de varias líneas ('reductive\nelimination') y mantiene el texto ancho cerca de la parte superior e inferior libre del arco. Aumentadistsi todavía se toca.- Tamaños típicos con texto de 10 pt: r = 55–65 pt.
Perfiles de energía
from cdxkit.energy import EnergyProfile, load_energies, common_sides
E = load_energies('energies.csv', column='M06/def2-TZVP') # {etiqueta: kcal/mol}, ver abajo
ep = EnergyProfile(energies=E) # valores predeterminados de liu-group; bars='bonds' opcional
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']) # comienza en una etiqueta conocida = se ramifica allí
ep.structure('TS1', draw_ts1) # draw_ts1(scene) dibuja el TS en cualquier lugar
# ep.note('M06/def2-TZVP/SMD(DCE)//B3LYP-D3(BJ)/6-31G(d)') # solo si el usuario lo solicita
ep.save('out/profile') # .cdxml + .png + comprobaciones + tabla de valores
- Números. Tómalos de la tabla del usuario, nunca de memoria o de una figura antigua.
- El CSV tiene la etiqueta en la primera columna y una columna por método, en kcal/mol en relación con una referencia. Las columnas cuyo encabezado comienza con
#son notas; una celda vacía o n.a. significa que no hay valor. - Un paso dado solo por su etiqueta se busca en esa tabla.
('TS1', 12.4)da el valor directamente; úsalo solo cuando no haya tabla. - La misma etiqueta en dos rutas es un punto. Debe tener la misma energía en ambas; da etiquetas diferentes a especies diferentes.
- El CSV tiene la etiqueta en la primera columna y una columna por método, en kcal/mol en relación con una referencia. Las columnas cuyo encabezado comienza con
- Opciones de paso (en el paso, como un dict):
add=,remove=: un reactivo que ingresa o un producto que sale en el conector al siguiente paso;at=,curve='above'|'below': dónde en ese conector toca la curva (0 a 1), y en qué lado del mismo va la curva. Si alguno se omite, la biblioteca prueba posiciones y ambos lados hasta que la curva y sus textos no toquen nada;shift=: un salto de escala en el conector i
…
[truncado para la traducción]