cdxkit을 사용한 ChemDraw 그림
cdxkit은 그림에 대한 짧은 Python 설명을 두 개의 파일로 변환합니다. CDXML(ChemDraw에서 열리며 완전히 편집 가능)과 PNG(ChemDraw 스타일, 600dpi로 렌더링)입니다. 라이브러리는 이 파일 옆 cdxkit/에 있으며, examples/의 예제가 그림을 어떻게 구성하는지 가장 빠르게 보여줍니다.
1. 내용과 스타일을 먼저 결정하세요
- 내용. 어떤 반응, 구조, 조건 및 숫자가 포함되며 각각이 어디에서 왔는지(논문, 사용자 자신의 ChemDraw 파일, 메모)를 결정합니다. 누락된 것이 있으면 물어보세요. 수율, 조건 또는 구조를 절대 기억에서 채우지 마세요.
- 스타일. 스타일은
styles/에 있습니다. 사용자가 이름으로 요청한 경우에만 사용하세요(또는 "1장 같은 스타일", "第 1 章那种风格"라고 말하면styles/literature-rows.md를 사용). 사용자가 스타일을 지정하지 않은 경우 한 번 물어보고 다음 옵션을 제시하세요:acs-plain: ChemDraw의 ACS Document 1996 기본값, 검정색만 사용(styles/acs-plain.md);literature-rows: 행당 하나의 문헌 반응, 고정된 의미를 가진 몇 가지 색상, 순환에 곡선 화살표 사용(styles/literature-rows.md);liu-group: 계산 그림, 즉 에너지 프로파일, 전이 상태 및 중간체, Liu 그룹 SOP에 따름(styles/liu-group.md; "刘组风格"도 가능);- 사용자가 제공하는 그림 또는 사양과 일치시킵니다. 사용자가 선택하지 않은 스타일의 색상이나 레이아웃 규칙을 적용하지 마세요. 스타일이 지정되지 않은 에너지 프로파일의 경우 liu-group을 먼저 제안하세요. 프로파일에 대한 규칙이 있는 유일한 스타일입니다.
2. 모든 스타일에서 유지되는 규칙
-
출처에 충실. 각 구조를 출처가 그린 대로 그리세요: 동일한 방향, 동일한 입체화학(제품을 "맞추기" 위해 반전시키거나 뒤집지 마세요. 뒤집힌 그림은 다른 입체 이성질체를 암시합니다). 조건과 숫자를 정확히 복사하고 숫자가 무엇인지 설명하세요(분리 수율 vs NMR 수율, d.r., ee). 출처를 사용할 수 없으면 추측하지 말고 그렇게 말하세요.
-
그림 내에서 일관성. 동일한 그림 내에서 동일한 종류의 것을 동일한 방식으로 그리세요(한 화합물을 구조로 표시하고 다른 화합물을 축약식으로 표시하지 마세요. 동일한 약어, 동일한 결합 길이, 동일한 레이블 스타일).
-
레이블이 올바르게 읽힘. 레이블은 결합된 원자가 결합에 닿도록 작성됩니다:
- 오른쪽에서 결합 →
OTIPS는TIPSO가 됩니다; - 왼쪽에서 결합 → 결합된 원자로 시작하세요, 예:
Fe(CO)<sub>2</sub>Cp*; - 위 또는 아래에서 결합 → 결합된 원자로 시작하고 왼쪽 정렬하세요, 예:
('OBBu<sub>2</sub>', 'left').
레이블을 표시되어야 하는 대로 작성하세요. CDXML에서 cdxkit은 결합 왼쪽에 있는 레이블을 ChemDraw의 입력 순서대로 저장합니다(
TIPSO는OTIPS로 저장됨). ChemDraw는 파일을 열거나 저장할 때 레이블을 그렇게 읽기 때문입니다. 레이블을 직접 반전시키지 마세요. - 오른쪽에서 결합 →
-
확인하세요. 항상 PNG를 렌더링하고 사용자에게 보여주기 전에 확인하세요. 다음을 확인하세요: 반전되거나 잘못 배치된 레이블, 겹치는 텍스트, 도달하지 않는 화살표, 비좁은 조건, 중앙에 오지 않은 행, 한 쪽의 빈 공간.
-
파일을 확인하세요.
layout.save()는name: self-check PASS와WARNING:줄을 출력합니다.- PASS는 CDXML이 RDKit으로 다시 읽혀 동일한 노드, 결합 및 유기 골격을 가짐을 의미합니다(
[Fe],L,Ar와 같은 레이블로만 구성된 조각은 개수만 확인). PNG가 어떻게 보이는지에 대해서는 아무 말도 하지 않습니다. - 두 가지 경고는 레이블 사이에 끼인 결합에 관한 것입니다. 두 경우 모두 결합을 늘리거나(
L.ML금속 결합) 레이블을 이동하세요:- "bond X-Y … is hidden by its labels": 결합이 PNG에서 누락되었습니다(CDXML에는 여전히 있음);
- "bond X-Y … shows only n pt between its labels": 결합이 너무 짧아 읽을 수 없습니다. 약 4pt보다 짧은 점선 TS 결합은 실선처럼 보입니다.
- ChemDraw가 설치된 Windows에서
cdxkit.chemdraw.export()는 CDXML을 ChemDraw에서 열고 ChemDraw로 렌더링된 PNG/CDX를 저장합니다. ChemDraw가 이미 열려 있으면 실행을 거부하며(사용자에게 저장되지 않은 작업이 있을 수 있음) 시작하지 않은 ChemDraw를 절대 종료하지 않습니다.
- PASS는 CDXML이 RDKit으로 다시 읽혀 동일한 노드, 결합 및 유기 골격을 가짐을 의미합니다(
-
전달
.cdxml(ChemDraw에서 편집용)과.png를 전달하고 사용자가 수동으로 조정해야 할 사항을 나열하세요(제한 사항 참조).
3. 라이브러리 사용하기
import sys; sys.path.insert(0, r'<이 스킬 폴더>')
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, 결합 14.4 pt
m, box = L.place(s, 'C=CCC', 10, 60) # SMILES -> 원자; box = 잉크 경계 상자
fe = s.add_atom_label(*L.metal_above(m[0], m[1]), '[Fe]<sup>+</sup>')
L.eta2(s, fe, m[0], m[1]) # C=C 중간점까지 점선 에타-2 선
L.add_h(s, m[2], deg=-90, color='red') # 명시적 H (선택적 색상)
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, 자체 검사 출력
좌표는 포인트(1/72인치)이며, y는 아래쪽으로 증가합니다. 각도는 종이에서 시계 반대 방향 도수(0 = 오른쪽, 90 = 위쪽)입니다.
원자는 위치로 찾습니다. add_bond(p1, p2)는 p1/p2에 있는 원자(0.6 pt 이내)를 연결하므로 기존 원자 위에 두 번째 조각을 그리지 마세요("원점에 그린 다음 나중에 이동"은 잘못됩니다). 각 부분을 최종 위치에 그리거나 자체 Scene에 그린 다음 L.merge(s, part, dx, dy)로 복사하세요. RowFigure는 모든 행에 대해 이미 이 작업을 수행합니다. 라이브러리는 원자가 다른 원자 위에 착지할 때 경고하고 save()는 결합 없이 남은 레이블을 나열합니다. 텍스트는 <sub> <sup> <i> <b>, \n 및 HTML 엔터티(′ ′, π π, ° °)를 허용합니다.
| 필요 | 호출 |
|---|---|
| 크기 | L.BL = 14.4 pt (C–C 결합), L.ML = 21 pt (금속–리간드 결합) |
| SMILES에서 분자 | L.place(s, smi, left, cy, rotate=, flip=, labels={i: 'Ar'}, align_atom=None) → (AtomMap, 잉크 상자); cy는 잉크 상자를 중앙에 배치하거나 원자 align_atom을 높이 cy에 배치합니다(사슬을 화살표 축에 놓기 위해). L.place_center(...); L.ink_size(smi); L.orient(smi, i, j, deg, flip=)는 결합 i→j를 deg로 향하게 하는 rotate를 제공합니다(place에 동일한 flip을 전달). AtomMap은 스냅샷입니다. 원자를 이동한 후 다시 조회하세요. *의 금속은 C–C 길이 결합을 얻습니다. L.stretch(s, m[c], m[star], L.ML)로 길게 하세요. * 원자에 약어를 배치하세요. SMILES에 입체화학을 지정하세요, 예: SMILES C/C=C(\*)c1ccccc1 (Python 문자열 'C/C=C(\\*)c1ccccc1'). |
| 손으로 그린 조각 | `s.add_atom_label(x, y, text, align=None |
| 레이블 / 결합 색칠 | s.paint(p, 'navy') (p의 원자 레이블), s.color_bond(p1, p2, 'red', style='bold') |
| 각도로 점 | L.pol(p, deg, d=L.BL) |
| π 결합 위의 금속 | L.metal_above(a1, a2), L.eta2(s, metal, a1, a2) |
| 명시적 H | L.add_h(s, p, deg=None, color=None) (deg=None: 열린 방향) |
| 알렌 중심 점 | L.allene_dot(s, p) |
| 화살표 | L.arrow_with_conditions(s, x1, y, above=[...], below=[...], eq=False), `s.add_arrow(x1, y1, x2, y2, head='full' |
| 의자 / 보트 (6원 고리 전이 상태) | L.chair(center, side=L.ML, mirror=False, flip=False) → 고리 순서의 6개 위치(일반 선 교과서 의자); L.boat(center, side=, mirror=, flip=) → ChemDraw의 보트 템플릿 위치(앞쪽 가장자리를 굵게 그리고 끝에서 앞쪽 가장자리까지의 모서리를 쐐기로 그림; docstring 참조). L.polygon(center, n, side=)는 평면 고리에만 해당 |
| 에너지 프로파일 | 아래 "에너지 프로파일" 참조 |
| 텍스트 | `s.add_text(x, y, text, align=, valign='baseline' |
| 상자 | L.fill_box(s, box_or_Mark, pad=4, fill='fill') (구조 뒤에 타일), 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) |
| 색상 | 팔레트 이름 red navy grey fill rule redfill navyfill greyfill darkblue darkred (grey = #797979, darkblue #011993 및 darkred #941100은 liu-group 경로 색상임); 더 많은 색상은 register_color('teal', '#13786F')로 등록 |
| 반응당 한 행 | `L.RowFigure(width=468, title_position='top' |
| 조각 결합 | L.merge(s, part, dx, dy)는 장면 part를 s로 복사합니다 |
| 촉매 순환 | 아래 "촉매 순환" 참조 |
| 부분 이동 / 측정 | mk = L.Mark(s) … 그리기 … mk.bbox(), mk.shift(dx, dy) |
| 출력 | L.save(s, base) → base.cdxml, base.png + 자체 검사 (s.check_cdxml은 먼저 s.to_cdxml이 필요함; save는 둘 다 수행); cdxkit.chemdraw.export(cdxml, [png, cdx]) |
금속 중심 및 레이블
-
원자 레이블은 자동으로 고정됩니다:
- 양쪽에 결합되거나 세 개 이상의 결합이 있는 레이블 또는 금속 기호는 원자 중앙에 배치됩니다(
Ar–Pd–X와 두 개의PPh3,L–Pd<sup>II</sup>–L); - 결합이 오른쪽에서 오는 레이블은 오른쪽 정렬됩니다(
Fp–CH2,TIPSO–); - 그렇지 않으면 왼쪽 정렬되어 첫 번째 문자가 원자에 위치합니다(금속 위 또는 아래의
PPh3).
align='left'|'right'|'center'로 재정의하세요. 레이블은 중간 문자(예:Cp*Fe(CO)2의 Fe)에 고정될 수 없습니다. 결합된 원자가 처음 또는 마지막에 오도록 작성하세요. - 양쪽에 결합되거나 세 개 이상의 결합이 있는 레이블 또는 금속 기호는 원자 중앙에 배치됩니다(
-
금속-리간드 결합에는
L.ML을 사용하세요. 두 레이블이 너무 가까워서 그 사이의 결합이 사라질 경우save()가 경고합니다.
촉매 순환
cyc = Cycle(s, cx, cy, r, clockwise=True, hook_radius=17, hook_sweep=72)
cyc.arc(62, 16) # 호 화살표, 머리가 16도 (시계 방향)
cyc.hook(54, 'in', 'base') # 시약이 54도에서 결합
cyc.hook(34, 'out', 'BH<sup>+</sup>') # 부산물이 34도에서 떠남
cyc.hook(148, 'in', draw_fn) # draw_fn(scene, (x, y)): 구조
cyc.label(26, 'deprotonation', dist=8, color='navy') # 단계 이름 내부, 호 옆
- 후크는
theta에서 순환에 닿고 바깥쪽으로 말립니다. 시계 방향 순환의 경우'in'후크의 자유 끝은 상류(세타의 시계 반대 방향)에 있고'out'후크의 자유 끝은 하류에 있습니다. 자유 끝이 빈 공간에 놓이도록 세타를 선택하세요. - 레이블 또는 구조는 자유 끝 너머로 이동합니다. 순환 오른쪽 절반에서는 오른쪽으로, 왼쪽 절반에서는 왼쪽으로, 상단과 하단 근처에서는 중앙에 배치됩니다.
side='left'|'right'|'center'로 측면을 강제하고,gap=으로 거리를 설정하며,head_in='full'은 'in' 후크에 머리를 넣습니다. cyc.label은 여러 줄 텍스트를 허용하며('reductive\nelimination') 넓은 텍스트를 상단과 하단 근처에 호와 겹치지 않도록 유지합니다. 여전히 닿으면dist를 늘리세요.- 10pt 텍스트의 일반적인 크기: r = 55–65 pt.
에너지 프로파일
from cdxkit.energy import EnergyProfile, load_energies, common_sides
E = load_energies('energies.csv', column='M06/def2-TZVP') # {label: kcal/mol}, 아래 참조
ep = EnergyProfile(energies=E) # liu-group 기본값; bars='bonds' 선택 사항
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']) # 알려진 레이블에서 시작 = 거기서 분기
ep.structure('TS1', draw_ts1) # draw_ts1(scene)는 TS를 어디든 그림
# ep.note('M06/def2-TZVP/SMD(DCE)//B3LYP-D3(BJ)/6-31G(d)') # 사용자가 요청한 경우에만
ep.save('out/profile') # .cdxml + .png + 검사 + 값 표
- 숫자. 사용자의 표에서 가져오고, 절대 기억이나 이전 그림에서 가져오지 마세요.
- CSV는 첫 번째 열에 레이블이 있고 방법당 하나의 열이 있으며, 하나의 기준점에 대한 kcal/mol 단위입니다. 헤더가
#으로 시작하는 열은 참고 사항입니다. 빈 셀이나 n.a.는 값이 없음을 의미합니다. - 레이블로만 제공되는 단계는 해당 표에서 조회됩니다.
('TS1', 12.4)는 값을 직접 제공합니다. 표가 없을 때만 사용하세요. - 두 경로에 동일한 레이블은 하나의 지점입니다. 두 경로에서 동일한 에너지를 가져야 합니다. 다른 종에는 다른 레이블을 지정하세요.
- CSV는 첫 번째 열에 레이블이 있고 방법당 하나의 열이 있으며, 하나의 기준점에 대한 kcal/mol 단위입니다. 헤더가
- 단계 옵션(단계에 대한 사전):
add=,remove=: 다음 단계로의 연결부에 들어가는 시약 또는 떠나는 생성물;at=,curve='above'|'below': 해당 연결부에서 곡선이 닿는 위치(0에서 1까지) 및 곡선이 지나는 측면. 둘 중 하나가 생략되면 라이브러리는 곡선과 텍스트가 아무것도 닿지 않을 때까지 위치와 양쪽 측면을 시도합니다;shift=: 연결부의 축척 구분
…
[번역 잘림]