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
-
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.
-
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).
-
Rótulos lidos corretamente. Um rótulo é escrito de modo que o átomo ligado toque a ligação:
- ligação da direita →
OTIPSviraTIPSO; - 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 comoOTIPS), porque o ChemDraw lê os rótulos dessa forma ao abrir ou salvar um arquivo. Não inverta os rótulos você mesmo. - ligação da direita →
-
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.
-
Verifique o arquivo.
layout.save()imprimename: self-check PASSmais quaisquer linhasWARNING:.- 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,Arsã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.MLpara 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.
- 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
-
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 (′ ′, π π, ° °).
| Necessidade | Chamada |
|---|---|
| tamanhos | L.BL = 14.4 pt (ligação C–C), L.ML = 21 pt (ligação metal–ligante) |
| molécula a partir de SMILES | L.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ção | s.paint(p, 'navy') (rótulo do átomo em p), s.color_bond(p1, p2, 'red', style='bold') |
| ponto em um ângulo | L.pol(p, deg, d=L.BL) |
| metal em uma ligação π | 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: direção aberta) |
| ponto central de aleno | L.allene_dot(s, p) |
| setas | L.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 energia | consulte "Perfis de energia" abaixo |
| texto | `s.add_text(x, y, text, align=, valign='baseline' |
| caixas | L.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) |
| cores | nomes 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ças | L.merge(s, part, dx, dy) copia a cena part para s |
| mover / medir uma parte | mk = L.Mark(s) … desenhar … mk.bbox(), mk.shift(dx, dy) |
| saída | L.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–Xcom doisPPh3,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 (
PPh3acima 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 deCp*Fe(CO)2); escreva-o de modo que o átomo ligado venha primeiro ou por último. - um rótulo ou símbolo metálico ligado em ambos os lados, ou com três ou mais ligações, é centralizado no átomo (
-
Use
L.MLpara 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
thetae 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.labelaceita texto multilinha ('reductive\nelimination') e mantém o texto largo perto do topo e da base longe do arco. Aumentedistse 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.
- 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
- 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]