Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Python API

icstudio Python 패키지를 쓰면 스크립트와 노트북에서 IC Studio 프로젝트를 열 수 있습니다. 넷리스트로 회로도를 만들고, 전체 파형으로 시뮬레이션하고, DRC, LVS, 검증 계획을 실행하고, MCP 도구를 무엇이든 호출할 수 있습니다. 앱과 ics 명령줄이 쓰는 Rust 코드를 같은 프로세스 안에서 실행하므로, 앱을 띄워 둘 필요가 없습니다.

설치

패키지는 저장소에서 maturin으로 빌드합니다. Rust(설치 참고)와 Python 3.9 이상이 필요합니다.

pip install ./python            # 저장소 체크아웃에서
pip install numpy               # 선택: 파형을 NumPy 배열로

첫 스크립트

import icstudio

p = icstudio.Project.open("myproj")      # 기존 프로젝트
# p = icstudio.Project.create("newproj", template="empty")   # 새 프로젝트(바로 저장됨)
# p = icstudio.Project.demo()            # 메모리 속 데모 셀

print(p.cells())                         # ['work/ota5t', 'work/rc_lowpass', ...]

p.write_schematic("work/divider", """
V1 a 0 1.8
R1 a b 10k
R2 b 0 10k
.op
""")
r = p.simulate("divider")
print(r["op"]["vectors"]["v(b)"])        # [0.9]
p.save()

변경 사항은 save()(다른 곳에 저장하려면 save("other/dir"))를 부를 때까지 메모리에만 있습니다.

시뮬레이션 결과

simulate(cell)은 셀에 저장된 해석을 실행하고 전체 파형을 돌려줍니다. 결과는 해석 이름(op, dc, ac, tran, noise)을 키로 하는 dict입니다.

r = p.simulate("rc_lowpass", backend="builtin")    # backend: builtin, ngspice, auto
ac = r["ac"]
f = ac["vectors"][ac["scale"]]           # 스윕 변수: 주파수
h = ac["vectors"]["v(out)"]              # AC는 복소수

import numpy as np
fc = f[np.argmin(abs(abs(h) - 1 / np.sqrt(2)))]    # -3 dB 주파수

각 해석에는 title, scale(스윕 벡터 이름), vectors(이름별 값)가 있고, 동작점 해석에는 devices(소자별 동작점 값과 영역)도 있습니다. NumPy가 설치되어 있으면 벡터는 NumPy 배열이고, 없으면 리스트입니다. simulate(cell, parasitics=True)는 레이아웃에서 추출한 기생 성분을 포함합니다. icstudio.run_spice(deck)는 SPICE나 Spectre 덱을 그 덱의 해석으로 시뮬레이션하고 같은 형태로 돌려줍니다.

메서드

메서드기능
Project.open(path), Project.create(path, template), Project.demo()열기, 만들기(demo 또는 empty), 데모 불러오기
name, root, cells(), info()프로젝트 이름, 디렉터리, 셀(lib/cell), 라이브러리와 테크놀로지
netlist(cell, format)넷리스트: spice(해석 포함), spectre, cdl
write_schematic(cell, netlist, overwrite)평탄 SPICE 넷리스트로 회로도 만들기
simulate(cell, parasitics, backend)저장된 해석의 전체 파형
drc(cell), lvs(cell)테크놀로지 덱으로 DRC, 레이아웃 대 회로도
verify(tests, save)검증 계획: 스펙별 worst 값, 마진, 상태
skill(code)프로젝트에서 Cadence SKILL 실행
call(tool, **args)이름으로 MCP 도구 호출
save(path)저장(다른 이름으로 저장)

모든 MCP 도구

call은 MCP 서버의 도구를 키워드 인자로 실행하고, JSON 결과를 Python dict와 list로 돌려줍니다. icstudio.tools()는 도구 목록을 설명, 인자 스키마와 함께 보여 줍니다.

p = icstudio.Project.demo()
p.call("place_pcell", cell="cmos_inverter", kind="nmos", params={"w": 2, "l": 0.18}, x=10, y=0)
p.call("route", cell="cmos_inverter")
p.call("export_gds", cell="cmos_inverter", path="inv.gds")
[t["name"] for t in icstudio.tools()]

도구가 실패하면 그 메시지와 함께 icstudio.IcsError가 발생합니다.

예: CI에서 regression 검사

import sys
import icstudio

run = icstudio.Project.open("myproj").verify(save=True)
for t in run["tests"]:
    for s in t["specs"]:
        print(f'{t["name"]:12} {s["name"]:10} {s["status"]:5} worst {s["worst"]} at {s["at"]}')
regressions = [c for c in run["changes"] if c["regression"]]
sys.exit(1 if run["status"] in ("FAIL", "error") or regressions else 0)

셸에서는 ics verify가 같은 일을 하고 JUnit XML도 씁니다(명령줄 참고).