Community이미지github.com

chemdraw-figures

ChemDraw 그림(반응식, 문헌 반응 행, 촉매 순환, 금속-π 착물, DFT 에너지 기반 반응 에너지 프로파일, 전이 상태 구조)을 편집 가능한 ChemDraw CDXML과 PNG로 그립니다. 이 폴더의 cdxkit 파이썬 라이브러리를 사용합니다. 사용자가 ChemDraw 그림, 반응식, 촉매 순환 또는 에너지 프로파일을 그리거나 다시 그리거나 정리해 달라고 요청할 때 사용하세요(중국어 요청도 가능, 예: "画 ChemDraw 图", "画个催化循环", "画能量图", "照第 1 章那种风格画", "按刘组规范画"). 스타일은 선택 사항입니다. 사용자가 이름을 지정한 경우에만 styles/의 스타일을 사용하고, 스타일이 지정되지 않은 경우에는 그리기 전에 한 번 사용할 스타일을 물어보세요.

chemdraw-figures란 무엇인가요?

이 스킬은 AI 에이전트가 편집 가능한 ChemDraw CDXML과 고해상도 PNG 이미지를 생성할 수 있도록 하는 cdxkit 파이썬 라이브러리를 기반으로 합니다. 연구자가 반응식, 촉매 순환, 에너지 프로파일, 전이 상태 구조 등 다양한 화학 그림을 그려야 할 때 유용합니다. 이 라이브러리는 사용자가 SMILES 문자열, 좌표, 스타일 옵션을 지정하면 자동으로 CDXML 파일과 PNG 이미지를 생성하며, PNG 이미지는 600dpi 해상도로 ChemDraw 스타일과 유사하게 렌더링됩니다. 지원되는 스타일에는 ACS 일반 스타일(acs-plain), 문헌 반응 행 스타일(literature-rows), Liu 그룹 연산 프로토콜(liu-group)이 포함되며, 사용자가 특정 스타일을 요청하지 않으면 그리기 전에 한 번 스타일을 선택하도록 안내합니다. 에너지 프로파일의 경우 사용자의 CSV 파일에서 에너지 값을 불러오거나 직접 값을 지정할 수 있습니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 다양한 AI 에이전트 플랫폼에서 사용자에게 정확하고 일관된 ChemDraw 그림을 제공하여 화학 연구의 시각화 작업을 효율적으로 지원합니다.

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

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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. 모든 스타일에서 유지되는 규칙

  1. 출처에 충실. 각 구조를 출처가 그린 대로 그리세요: 동일한 방향, 동일한 입체화학(제품을 "맞추기" 위해 반전시키거나 뒤집지 마세요. 뒤집힌 그림은 다른 입체 이성질체를 암시합니다). 조건과 숫자를 정확히 복사하고 숫자가 무엇인지 설명하세요(분리 수율 vs NMR 수율, d.r., ee). 출처를 사용할 수 없으면 추측하지 말고 그렇게 말하세요.

  2. 그림 내에서 일관성. 동일한 그림 내에서 동일한 종류의 것을 동일한 방식으로 그리세요(한 화합물을 구조로 표시하고 다른 화합물을 축약식으로 표시하지 마세요. 동일한 약어, 동일한 결합 길이, 동일한 레이블 스타일).

  3. 레이블이 올바르게 읽힘. 레이블은 결합된 원자가 결합에 닿도록 작성됩니다:

    • 오른쪽에서 결합 → OTIPS는 TIPSO가 됩니다;
    • 왼쪽에서 결합 → 결합된 원자로 시작하세요, 예: Fe(CO)<sub>2</sub>Cp*;
    • 위 또는 아래에서 결합 → 결합된 원자로 시작하고 왼쪽 정렬하세요, 예: ('OBBu<sub>2</sub>', 'left').

    레이블을 표시되어야 하는 대로 작성하세요. CDXML에서 cdxkit은 결합 왼쪽에 있는 레이블을 ChemDraw의 입력 순서대로 저장합니다(TIPSO는 OTIPS로 저장됨). ChemDraw는 파일을 열거나 저장할 때 레이블을 그렇게 읽기 때문입니다. 레이블을 직접 반전시키지 마세요.

  4. 확인하세요. 항상 PNG를 렌더링하고 사용자에게 보여주기 전에 확인하세요. 다음을 확인하세요: 반전되거나 잘못 배치된 레이블, 겹치는 텍스트, 도달하지 않는 화살표, 비좁은 조건, 중앙에 오지 않은 행, 한 쪽의 빈 공간.

  5. 파일을 확인하세요. 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를 절대 종료하지 않습니다.
  6. 전달 .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 엔터티(&#8242; ′, &#960; π, &#176; °)를 허용합니다.

필요호출
크기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)
명시적 HL.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)는 값을 직접 제공합니다. 표가 없을 때만 사용하세요.
    • 두 경로에 동일한 레이블은 하나의 지점입니다. 두 경로에서 동일한 에너지를 가져야 합니다. 다른 종에는 다른 레이블을 지정하세요.
  • 단계 옵션(단계에 대한 사전):
    • add=, remove=: 다음 단계로의 연결부에 들어가는 시약 또는 떠나는 생성물;
    • at=, curve='above'|'below': 해당 연결부에서 곡선이 닿는 위치(0에서 1까지) 및 곡선이 지나는 측면. 둘 중 하나가 생략되면 라이브러리는 곡선과 텍스트가 아무것도 닿지 않을 때까지 위치와 양쪽 측면을 시도합니다;
    • shift=: 연결부의 축척 구분

…

[번역 잘림]

관련 스킬