CommunityImagemgithub.com

chemdraw-figures

Desenha figuras químicas (esquemas reacionais, séries de reações da literatura, ciclos catalíticos, complexos metal-π, perfis de energia reacional a partir de energias DFT, estruturas de estados de transição) como CDXML editável no ChemDraw mais um PNG, usando a biblioteca Python cdxkit. Use quando o usuário pedir para desenhar, redesenhar ou organizar uma figura, esquema, ciclo catalítico ou perfil de energia do ChemDraw (também em chinês, por exemplo: "画 ChemDraw 图", "画个催化循环", "画能量图", "照第 1 章那种风格画", "按刘组规范画"). Os estilos são opcionais: use um estilo de styles/ apenas quando o usuário o nomear; se nenhum estilo for nomeado, pergunte uma vez qual estilo usar antes de desenhar.

O que é chemdraw-figures?

Esta skill permite que um agente de IA (como Claude Code, Cursor ou Codex) desenhe figuras químicas profissionais e editáveis como arquivos CDXML (abertos no ChemDraw para edição completa) e PNGs de alta resolução. Ela usa a biblioteca Python `cdxkit`, incluída na pasta da skill, para construir figuras programaticamente a partir de descrições curtas, abrangendo esquemas reacionais, ciclos catalíticos, perfis de energia (a partir de energias DFT fornecidas em CSV), complexos metal-π e estruturas de estados de transição. A skill é útil para químicos computacionais e sintéticos que precisam gerar figuras padronizadas de forma eficiente, garantindo fidelidade às fontes, consistência interna e layout profissional. Ela suporta estilos predefinidos (como ACS plano, séries da literatura e grupo Liu) e permite que o usuário escolha um estilo antes do desenho. A implementação converte uma descrição Python em coordenadas gráficas, gerando tanto o CDXML editável (com ChemDraw) quanto o PNG renderizado (600 dpi), e inclui verificações automáticas de qualidade para evitar sobreposição de texto/fórmulas ou ligações escondidas.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Figuras ChemDraw com cdxkit

cdxkit transforma uma breve descrição Python de uma figura em dois arquivos: um CDXML que abre no ChemDraw e permanece totalmente editável, e um PNG renderizado para se parecer com o ChemDraw (600 dpi). A biblioteca está em cdxkit/ ao lado deste arquivo; os exemplos em examples/ são a maneira mais rápida de ver como uma figura é construída.

1. Definir conteúdo e estilo primeiro

  • Conteúdo. Quais reações, estruturas, condições e números entram, e de onde cada um vem (um artigo, o próprio arquivo ChemDraw do usuário, suas anotações). Se algo estiver faltando, pergunte; nunca preencha um rendimento, condição ou estrutura de memória.
  • Estilo. Os estilos ficam em styles/. Use um apenas quando o usuário o pedir pelo nome (ou disser, por exemplo, "como no Capítulo 1", "第 1 章那种风格" → styles/literature-rows.md). Se o usuário não nomeou um estilo, pergunte uma vez, oferecendo:
    • acs-plain: padrões ACS Document 1996 do ChemDraw, apenas preto (styles/acs-plain.md);
    • literature-rows: uma reação da literatura por linha, algumas cores com significados fixos, setas curvas para dentro/fora em ciclos (styles/literature-rows.md);
    • liu-group: figuras computacionais, ou seja, perfis de energia, estados de transição e intermediários, seguindo os SOPs do grupo Liu (styles/liu-group.md; também "刘组风格");
    • corresponder a uma figura ou especificação fornecida pelo usuário. Não aplique cores ou convenções de layout de um estilo que o usuário não escolheu. Para um perfil de energia sem estilo nomeado, ofereça liu-group primeiro: é o único estilo com regras para perfis.

2. Regras que valem para todos os estilos

  1. Fiel à fonte. Desenhe cada estrutura como a fonte a desenha: mesma orientação, mesma estereoquímica (não espelhe ou vire um produto "para encaixar"; um desenho invertido sugere um estereoisômero diferente). Copie condições e números exatamente, e diga o que o número representa (rendimento isolado vs RMN, r.r., e.e.). Se a fonte não estiver disponível, diga isso em vez de adivinhar.

  2. Consistente dentro de uma figura. O mesmo tipo de coisa é desenhado da mesma maneira em todos os lugares de uma figura (não mostre um composto como estrutura e outro como fórmula condensada; mesma abreviação, mesmo comprimento de ligação, mesmo estilo de rótulo).

  3. Rótulos lidos corretamente. Um rótulo é escrito de modo que o átomo ligado toque a ligação:

    • ligação da direita → OTIPS vira TIPSO;
    • ligação da esquerda → comece com o átomo ligado, ex.: Fe(CO)<sub>2</sub>Cp*;
    • ligação de cima ou de baixo → comece com o átomo ligado e alinhe à esquerda, ex.: ('OBBu<sub>2</sub>', 'left').

    Escreva os rótulos como devem aparecer. No CDXML, o cdxkit armazena um rótulo que fica à esquerda de sua ligação na ordem digitada do ChemDraw (TIPSO é armazenado como OTIPS), porque o ChemDraw lê os rótulos dessa forma ao abrir ou salvar um arquivo. Não inverta os rótulos você mesmo.

  4. Olhe para ele. Sempre renderize o PNG e visualize-o antes de mostrá-lo ao usuário. Verifique: rótulos invertidos ou mal posicionados, texto sobreposto, setas que não alcançam, condições apinhadas, linhas não centralizadas, espaço vazio de um lado.

  5. Verifique o arquivo. layout.save() imprime name: self-check PASS mais quaisquer linhas WARNING:.

    • PASS significa que o CDXML é lido de volta pelo RDKit com os mesmos nós, ligações e esqueleto orgânico (fragmentos feitos apenas de rótulos como [Fe], L, Ar são verificados apenas por contagem). Não diz nada sobre a aparência do PNG.
    • Dois avisos referem-se a ligações espremidas entre rótulos; em ambos os casos, alongue a ligação (L.ML para ligações metálicas) ou mova os rótulos:
      • "bond X-Y … is hidden by its labels": a ligação está faltando no PNG (ainda está no CDXML);
      • "bond X-Y … shows only n pt between its labels": a ligação é muito curta para ser lida. Uma ligação tracejada de estado de transição com menos de cerca de 4 pt parece sólida.
    • No Windows com o ChemDraw instalado, cdxkit.chemdraw.export() abre o CDXML no ChemDraw e salva um PNG/CDX renderizado pelo ChemDraw. Ele se recusa a executar enquanto o ChemDraw já estiver aberto (o usuário pode ter trabalho não salvo) e nunca fecha um ChemDraw que não iniciou.
  6. Entregue o .cdxml (para edição no ChemDraw) e o .png, e liste qualquer coisa que o usuário ainda deva ajustar manualmente (consulte Limitações).

3. Usando a biblioteca

import sys; sys.path.insert(0, r'<pasta desta skill>')
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, ligação 14.4 pt
m, box = L.place(s, 'C=CCC', 10, 60)          # SMILES -> átomos; box = caixa da tinta
fe = s.add_atom_label(*L.metal_above(m[0], m[1]), '[Fe]<sup>+</sup>')
L.eta2(s, fe, m[0], m[1])                     # linha tracejada eta-2 até o ponto médio de C=C
L.add_h(s, m[2], deg=-90, color='red')        # H explícito (cor 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 auto-verificação

As coordenadas são pontos (1/72 pol.), y cresce para baixo; os ângulos são em graus anti-horários no papel (0 = direita, 90 = cima).

Átomos são encontrados por posição. add_bond(p1, p2) conecta qualquer átomo que esteja em p1/p2 (dentro de 0.6 pt), portanto nunca desenhe um segundo fragmento sobre um existente ("desenhar na origem, mover depois" dá errado). Desenhe cada parte em sua posição final, ou desenhe-a em seu próprio Scene e copie-a com L.merge(s, part, dx, dy); RowFigure já faz isso para cada linha. A biblioteca avisa quando um átomo cai sobre outro, e save() lista rótulos deixados sem ligações. O texto aceita <sub> <sup> <i> <b>, \n e entidades HTML (&#8242; ′, &#960; π, &#176; °).

NecessidadeChamada
tamanhosL.BL = 14.4 pt (ligação C–C), L.ML = 21 pt (ligação metal–ligante)
molécula a partir de SMILESL.place(s, smi, left, cy, rotate=, flip=, labels={i: 'Ar'}, align_atom=None) → (AtomMap, caixa da tinta); cy centraliza a caixa da tinta, ou coloca o átomo align_atom na altura cy (para colocar uma cadeia no eixo da seta). L.place_center(...); L.ink_size(smi); L.orient(smi, i, j, deg, flip=) fornece o rotate que aponta a ligação i→j para deg (passe o mesmo flip que para place). AtomMaps são instantâneos: após mover átomos, procure-os novamente. Um metal em um * obtém uma ligação de comprimento C–C; alongue-a com L.stretch(s, m[c], m[star], L.ML). Coloque abreviações em átomos *; forneça estereoquímica no SMILES, ex.: SMILES C/C=C(\*)c1ccccc1 (em uma string Python 'C/C=C(\\*)c1ccccc1').
fragmento desenhado à mão`s.add_atom_label(x, y, text, align=None
colorir um rótulo / ligaçãos.paint(p, 'navy') (rótulo do átomo em p), s.color_bond(p1, p2, 'red', style='bold')
ponto em um ânguloL.pol(p, deg, d=L.BL)
metal em uma ligação πL.metal_above(a1, a2), L.eta2(s, metal, a1, a2)
H explícitoL.add_h(s, p, deg=None, color=None) (deg=None: direção aberta)
ponto central de alenoL.allene_dot(s, p)
setasL.arrow_with_conditions(s, x1, y, above=[...], below=[...], eq=False), `s.add_arrow(x1, y1, x2, y2, head='full'
cadeira / barco (ET de seis membros cíclico)L.chair(center, side=L.ML, mirror=False, flip=False) → 6 posições na ordem do anel (cadeira de livro-texto com linha simples); L.boat(center, side=, mirror=, flip=) → posições do template de barco do ChemDraw (desenhe a borda frontal em negrito, bordas da ponta à frente como cunhas; consulte docstring). L.polygon(center, n, side=) é apenas para anéis planares
perfil de energiaconsulte "Perfis de energia" abaixo
texto`s.add_text(x, y, text, align=, valign='baseline'
caixasL.fill_box(s, box_or_Mark, pad=4, fill='fill') (bloco atrás de uma estrutura), 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)
coresnomes da paleta red navy grey fill rule redfill navyfill greyfill darkblue darkred (grey = #797979, darkblue #011993 e darkred #941100 são as cores das vias liu-group); mais com register_color('teal', '#13786F')
uma linha por reação`L.RowFigure(width=468, title_position='top'
combinar peçasL.merge(s, part, dx, dy) copia a cena part para s
mover / medir uma partemk = L.Mark(s) … desenhar … mk.bbox(), mk.shift(dx, dy)
saídaL.save(s, base) → base.cdxml, base.png + auto-verificação (s.check_cdxml precisa de s.to_cdxml primeiro; save faz ambos); cdxkit.chemdraw.export(cdxml, [png, cdx])

Centros metálicos e rótulos

  • Os rótulos dos átomos são ancorados automaticamente:

    • um rótulo ou símbolo metálico ligado em ambos os lados, ou com três ou mais ligações, é centralizado no átomo (Ar–Pd–X com dois PPh3, L–Pd<sup>II</sup>–L);
    • um rótulo cuja ligação vem da direita é alinhado à direita (Fp–CH2, TIPSO–);
    • caso contrário, é alinhado à esquerda, de modo que o primeiro caractere fique no átomo (PPh3 acima ou abaixo de um metal).

    Substitua com align='left'|'right'|'center'. Um rótulo não pode ser ancorado em um caractere em seu meio (ex.: o Fe de Cp*Fe(CO)2); escreva-o de modo que o átomo ligado venha primeiro ou por último.

  • Use L.ML para ligações metal–ligante. Se dois rótulos ficarem tão próximos que a ligação entre eles desapareceria, save() avisa.

Ciclos catalíticos

cyc = Cycle(s, cx, cy, r, clockwise=True, hook_radius=17, hook_sweep=72)
cyc.arc(62, 16)                                     # seta de arco, cabeça a 16 graus (horário)
cyc.hook(54, 'in', 'base')                          # reagente entra a 54 graus
cyc.hook(34, 'out', 'BH<sup>+</sup>')               # subproduto sai a 34 graus
cyc.hook(148, 'in', draw_fn)                        # draw_fn(scene, (x, y)): uma estrutura
cyc.label(26, 'deprotonation', dist=8, color='navy')   # nome da etapa dentro, próximo ao seu arco
  • Um gancho toca o ciclo em theta e se curva para fora. Para um ciclo horário, a extremidade livre de um gancho 'in' fica a montante (anti-horário de theta) e a de um gancho 'out' fica a jusante. Escolha theta de modo que a extremidade livre caia em espaço vazio.
  • O rótulo ou estrutura vai além da extremidade livre: à sua direita na metade direita do ciclo, à sua esquerda na metade esquerda, centralizado perto do topo e da base. Force um lado com side='left'|'right'|'center'; gap= define a distância; head_in='full' coloca uma cabeça em um gancho 'in'.
  • cyc.label aceita texto multilinha ('reductive\nelimination') e mantém o texto largo perto do topo e da base longe do arco. Aumente dist se ainda tocar.
  • Tamanhos típicos com texto de 10 pt: r = 55–65 pt.

Perfis de energia

from cdxkit.energy import EnergyProfile, load_energies, common_sides
E = load_energies('energies.csv', column='M06/def2-TZVP')   # {rótulo: kcal/mol}, veja abaixo
ep = EnergyProfile(energies=E)                  # padrões 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'])                    # começa em um rótulo conhecido = ramifica lá
ep.structure('TS1', draw_ts1)                   # draw_ts1(scene) desenha o ET em qualquer lugar
# ep.note('M06/def2-TZVP/SMD(DCE)//B3LYP-D3(BJ)/6-31G(d)')  # apenas se o usuário pedir
ep.save('out/profile')                          # .cdxml + .png + verificações + tabela de valores
  • Números. Retire-os da tabela do usuário, nunca da memória ou de uma figura antiga.
    • O CSV tem o rótulo na primeira coluna e uma coluna por método, em kcal/mol relativas a uma referência. Colunas cujo cabeçalho começa com # são notas; uma célula vazia ou n.a. significa nenhum valor.
    • Uma etapa dada apenas por seu rótulo é procurada nessa tabela. ('TS1', 12.4) fornece o valor diretamente; use-o apenas quando não houver tabela.
    • O mesmo rótulo em duas vias é um ponto. Deve ter a mesma energia em ambas; dê a espécies diferentes rótulos diferentes.
  • Opções de etapa (na etapa, como um dicionário):
    • add=, remove=: um reagente entrando ou um produto saindo no conector para a próxima etapa;
    • at=, curve='above'|'below': onde nesse conector a curva toca (0 a 1), e de que lado dela a curva vai. Se algum for omitido, a biblioteca tenta posições e ambos os lados até que a curva e seus textos não toquem nada;
    • shift=: uma quebra de escala no conector i< ...

[truncado para tradução]

Habilidades Relacionadas