CommunityImagengithub.com

chemdraw-figures

Dibuja figuras químicas (esquemas de reacción, filas de reacciones de la literatura, ciclos catalíticos, complejos metal-π, perfiles de energía de reacción a partir de energías DFT, estructuras de estado de transición) como CDXML editable de ChemDraw más un PNG, utilizando la biblioteca Python cdxkit en esta carpeta. Úsalo cuando el usuario pida dibujar, redibujar o ordenar una figura, esquema, ciclo catalítico o perfil de energía de ChemDraw (también en chino, por ejemplo, '画 ChemDraw 图', '画个催化循环', '画能量图', '照第 1 章那种风格画', '按刘组规范画'). Los estilos son opcionales: usa un estilo de styles/ solo cuando el usuario lo nombre; si no se nombra ningún estilo, pregunta una vez qué estilo usar antes de dibujar.

¿Qué es chemdraw-figures?

Esta habilidad permite a un agente de IA generar figuras químicas listas para publicar como archivos CDXML editables de ChemDraw y archivos PNG renderizados, utilizando la biblioteca Python cdxkit. Es útil para químicos sintéticos, orgánicos, organometálicos y computacionales que necesitan crear esquemas de reacción, ciclos catalíticos, perfiles de energía de reacción y estructuras de estado de transición de manera programática. La habilidad se basa en un conjunto de reglas estrictas para garantizar fidelidad a la fuente, consistencia dentro de la figura y renderizado correcto, incluyendo la alineación de etiquetas y la verificación de errores comunes. Soporta múltiples estilos de diseño (por ejemplo, ACS plain, filas de la literatura, grupo Liu) y puede manejar entradas en chino o inglés, preguntando primero por el estilo si el usuario no lo especifica. El flujo de trabajo típico implica que el usuario describa el contenido y la fuente, y la habilidad produce el CDXML y PNG listos para usar o enviar.

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

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

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

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

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

  3. Las etiquetas se leen correctamente. Una etiqueta se escribe de modo que el átomo enlazado toque el enlace:

    • enlace desde la derecha → OTIPS se convierte en TIPSO;
    • 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 (TIPSO se almacena como OTIPS), porque ChemDraw lee las etiquetas de esa manera cuando abre o guarda un archivo. No inviertas las etiquetas tú mismo.

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

  5. Verifica el archivo. layout.save() imprime name: self-check PASS más cualquier línea WARNING:.

    • 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, Ar se 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.ML para 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ó.
  6. 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 (&#8242; ′, &#960; π, &#176; °).

NecesidadLlamada
tamañosL.BL = 14.4 pt (enlace C–C), L.ML = 21 pt (enlace metal–ligando)
molécula desde SMILESL.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 / enlaces.paint(p, 'navy') (etiqueta de átomo en p), s.color_bond(p1, p2, 'red', style='bold')
punto en un ánguloL.pol(p, deg, d=L.BL)
metal en un enlace πL.metal_above(a1, a2), L.eta2(s, metal, a1, a2)
H explícitoL.add_h(s, p, deg=None, color=None) (deg=None: dirección abierta)
punto central de alenoL.allene_dot(s, p)
flechasL.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íaver "Perfiles de energía" a continuación
texto`s.add_text(x, y, text, align=, valign='baseline'
cuadrosL.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)
coloresnombres 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 piezasL.merge(s, part, dx, dy) copia la escena part en s
mover / medir una partemk = L.Mark(s) … dibujar … mk.bbox(), mk.shift(dx, dy)
salidaL.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–X con dos PPh3, 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 (PPh3 arriba 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 de Cp*Fe(CO)2); escríbela de modo que el átomo enlazado venga primero o último.

  • Usa L.ML para 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 theta y 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.label acepta texto de varias líneas ('reductive\nelimination') y mantiene el texto ancho cerca de la parte superior e inferior libre del arco. Aumenta dist si 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.
  • 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]

Skills relacionados