본문으로 건너뛰기

오픈 CAD와 코드 기반 설계

📍 현재 위치: 3부 · 소프트웨어 스택 — 16장 중 7장. 슬라이서는 모델을 G-code로 바꿉니다. 이 장은 모델 자체를 오픈 도구로, 특히 코드로 만드는 이야기입니다.

쉽게 말하면

도면은 물체 하나를 그린 그림입니다. 레시피는 같은 물체의 여러 버전을 만들 수 있는 지침입니다. 밀가루를 더 넣고 달걀을 덜 넣어도 방법은 같습니다. 코드 기반 CAD가 바로 레시피 방식입니다. 브래킷을 어떻게 만드는지(판 하나, 구멍 네 개, 둥근 모서리)를 적어 두고, "길이 60 mm"를 "길이 80 mm"로 바꿔 다시 빌드합니다. 레시피는 평범한 텍스트 파일이므로, 프로그래머가 소프트웨어에 하듯 모든 버전을 보관하고, 버전끼리 비교하고, 공유할 수도 있습니다.

이 장에서 다루는 내용​

주요 오픈소스 CAD 도구를 마우스로 다루는 것과 코드로 다루는 것으로 나누어 비교합니다. 그다음 같은 장착 플레이트를 OpenSCAD, CadQuery, build123d 세 가지 방식으로 만들고 각각 실행해 결과를 수치로 확인합니다. 끝으로 버전 관리 아래의 재현 가능한 설계와, 도형을 그리는 데 그치지 않고 제안까지 하는 알고리즘인 "생성적 설계(generative design)"를 솔직하게 짧게 살펴봅니다.

오픈 도구 지도​

도구방식프로젝트가 스스로 밝히는 내용
FreeCADPython API를 갖춘 매개변수형 GUI 모델러오픈소스 매개변수형 3D 모델러, 기하 커널은 OpenCASCADE, LGPL-2.1 라이선스 [1]
OpenSCAD스크립트 기반 솔리드 모델링"대화형 모델러가 아니며", 스크립트를 읽는 3D 컴파일러에 가까움, CSG와 2D 윤곽 압출, GPL v2 [2]
CadQueryPython 라이브러리, 경계 표현(B-rep) CADOpenCASCADE 커널 기반, Apache-2.0, STEP·STL·AMF·3MF 등으로 내보냄 [3]
build123dPython B-rep 프레임워크역시 OpenCASCADE 기반, Apache-2.0, CadQuery 코드 일부를 가져왔지만 따로 크게 다듬은 별개 프레임워크 [4]
libfive암시적(함수 기반) 모델링형상을 수학 함수로 정의, 메시화로 워터타이트·매니폴드 삼각형 메시를 생성, 라이브러리는 MPL 2, Studio GUI는 GPL v2 이상 [5]; 바탕의 고체 함수 표현 개념은 1995년 논문에서 정리되었습니다 [6]
Blender범용 3D 제작 도구, 메시 중심자유·오픈소스, 전체적으로 GPL v3 [7]

용어 두 개를 풀어 둡니다. B-rep(boundary representation, 경계 표현)은 고체를 정확한 경계면(평면, 원통, 스플라인)으로 기술하므로 구멍이 진짜 원통입니다. 메시(mesh)는 작은 삼각형 여러 개로 기술하므로 구멍은 변이 많은 다각형입니다. B-rep 도구(FreeCAD, CadQuery, build123d)는 정확한 STEP 파일을 내보낼 수 있고, Blender 같은 메시 중심 도구는 치수가 있는 매개변수형 특징이 아니라 삼각형을 직접 다룹니다. OpenSCAD는 그 중간에 있습니다. CSG로 작업하며, 매뉴얼에 나열된 내보내기 형식(STL, 3MF, AMF, OFF 등)은 메시 또는 2D 도면이고 STEP은 없습니다 [8]. 내보내기 지원은 도구마다 다르므로 하나를 택하기 전에 확인하세요.

여섯 가지 오픈 CAD 도구(FreeCAD, CadQuery, build123d, OpenSCAD, libfive, Blender)가 매개변수를 담은 텍스트 소스로 모이고, 이 소스에서 STEP, STL, 3MF 파일이 내보내지는 모습. 서로 다른 오픈 도구, 하나의 작업 흐름. 매개변수형 텍스트 소스를 필요할 때 다시 빌드하여 STEP, STL, 3MF 같은 파일로 내보냅니다. 저자가 AI의 도움을 받아 직접 제작한 그림입니다.

이 장을 위해 FreeCAD와 Blender는 실행하지 않았으므로 위 표는 시험 결과가 아니라 각 프로젝트가 스스로 밝힌 설명에 근거합니다.

하나의 부품, 세 가지 방법​

시험용 부품은 60 × 30 × 4 mm 직사각형 장착 플레이트이며, 가장자리에서 8 mm 안쪽에 5 mm 구멍 네 개가 있습니다. 모든 치수가 매개변수입니다.

OpenSCAD​

// Parametric mounting plate. Override on the command line with -D.
length = 60; // mm
width = 30; // mm
thickness = 4; // mm
hole_d = 5; // mm
hole_inset = 8; // mm
$fn = 48;

difference() {
cube([length, width, thickness]);
for (x = [hole_inset, length - hole_inset], y = [hole_inset, width - hole_inset])
translate([x, y, -1]) cylinder(d = hole_d, h = thickness + 2);
}

명령줄은 GUI를 열지 않고 렌더링합니다. -o는 출력 파일을 지정하고 확장자가 형식을 고르며, -D는 변수를 덮어씁니다 [8]. 그러면 매개변수 스윕은 셸 반복문 하나입니다.

for L in 40 60 80; do openscad -o plate_$L.stl -D length=$L bracket.scad; done

실행 상태: macOS에 설치한 OpenSCAD 개발 스냅샷(버전 2026.10.11)으로 실행했습니다. 최상위 객체가 매니폴드라고 보고했고 ASCII STL(매뉴얼에 따른 CLI 기본값)을 썼습니다. 각 STL에서 부피를 계산하니 길이 40, 60, 80에서 약 4,487, 6,887, 9,287 mm³이었고, 최대 x 좌표는 각 길이와 일치했습니다. 제 시험에서는 Homebrew의 openscad cask가 비활성화되어 있어 openscad@snapshot을 사용했으며, 설치 경로는 환경에 따라 다를 수 있습니다. 원은 다각형임에 유의하세요. $fn = 48은 구멍을 48각 기둥으로 만들므로 부피가 이상적인 원보다 아주 조금 큽니다.

OpenSCAD에서 느린 단계는 불리언 연산이었습니다. 2023년의 풀 리퀘스트가 Manifold 라이브러리를 실험적 백엔드로 추가했으며, 작성자는 이전 fast-CSG 경로보다 대략 5-30배 빨라졌다고 보고했습니다. 같은 풀 리퀘스트는 Manifold가 OpenSCAD의 정확한 연산과 달리 단정밀도 부동소수점을 쓴다고도 적고 있습니다 [9]. Manifold의 README는 목표를 보장된 매니폴드 출력이라고 밝히며 OpenSCAD를 사용자 중 하나로 꼽습니다 [10].

CadQuery​

import cadquery as cq

# Parameters: change these and re-run; nothing else to edit.
length, width, thickness = 60.0, 30.0, 4.0 # mm
hole_d, hole_inset = 5.0, 8.0 # mm
fillet_r = 3.0 # mm

plate = (
cq.Workplane("XY")
.box(length, width, thickness)
.edges("|Z").fillet(fillet_r) # round the four vertical corners
.faces(">Z").workplane()
.rect(length - 2 * hole_inset, width - 2 * hole_inset, forConstruction=True)
.vertices().hole(hole_d) # one hole at each corner of the rectangle
)

cq.exporters.export(plate, "bracket.step")
cq.exporters.export(plate, "bracket.stl", tolerance=0.01, angularTolerance=0.1)
cq.exporters.export(plate, "bracket.3mf")

solid = plate.val()
expected = (length * width - (4 - 3.141592653589793) * fillet_r**2
- 4 * 3.141592653589793 * (hole_d / 2) ** 2) * thickness
print(f"volume {solid.Volume():.1f} mm^3, expected {expected:.1f}, valid={solid.isValid()}")
bb = solid.BoundingBox()
print(f"bbox {bb.xlen:.1f} x {bb.ylen:.1f} x {bb.zlen:.1f}")

CadQuery 문서는 각 호출이 형상을 선택하거나 수정하는, 쿼리를 이어 붙이는 듯한 플루언트(fluent) API를 설명합니다 [11]. README에 따르면 pip install cadquery는 제가 읽은 시점에 Python 3.9-3.12에서 동작했고 가상 환경 사용을 권장합니다 [3].

실행 상태: Python 3.12와 CadQuery 2.8.0이 설치된 새 가상 환경에서 실행했습니다. 출력은 volume 6854.9 mm^3, expected 6854.9, valid=True와 bbox 60.0 x 30.0 x 4.0이었습니다. 정확한 솔리드가 닫힌 형태의 부피 공식과 일치하는데, 이것이 B-rep의 핵심입니다. 필릿과 구멍이 다각형 근사가 아니라 정확합니다.

build123d​

from build123d import *

length, width, thickness = 60.0, 30.0, 4.0
hole_d, hole_inset = 5.0, 8.0
fillet_r = 3.0

with BuildPart() as plate:
Box(length, width, thickness)
fillet(plate.edges().filter_by(Axis.Z), fillet_r)
with Locations((length / 2 - hole_inset, width / 2 - hole_inset),
(-(length / 2 - hole_inset), width / 2 - hole_inset),
(length / 2 - hole_inset, -(width / 2 - hole_inset)),
(-(length / 2 - hole_inset), -(width / 2 - hole_inset))):
Hole(hole_d / 2)

export_step(plate.part, "b123d.step")
export_stl(plate.part, "b123d.stl")
print(f"volume {plate.part.volume:.1f} mm^3, valid={plate.part.is_valid}")

이것은 build123d의 빌더 모드로, BuildPart 같은 컨텍스트 블록이 설계 이력처럼 상태를 보관합니다. 연산자를 쓰는 상태 없는 대수(algebra) 모드도 제공합니다 [4]. 실행 상태: 같은 환경에서 build123d 0.12.0으로 실행했고, volume 6854.9 mm^3, valid=True를 출력해 CadQuery와 일치했습니다.

버전 관리 아래의 재현 가능한 설계​

코드 기반 CAD는 세 가지 면에서 값어치를 합니다. 소스가 텍스트이므로 git diff가 어떤 매개변수나 단계가 바뀌었는지 정확히 보여 주는데, 바이너리 파일로는 불가능합니다. 빌드가 반복 가능합니다. 같은 스크립트, 같은 도구 버전, 같은 매개변수는 같은 형상을 내야 하므로 도구 버전을 고정하고 생성된 STL은 저장소에 넣지 않거나 만든 버전을 태그로 붙이세요. 그리고 설계를 시험할 수 있습니다. 위의 CadQuery 스크립트는 자신의 부피를 공식과 유효성 플래그에 대해 검사하는데, 변경이 부품을 망가뜨리면 실패하는 CI 검사의 작은 버전입니다.

절충도 분명합니다. 스크립트에는 학습 곡선이 있고, 시각적으로 생각하는 사람은 FreeCAD의 스케치와 구속 조건을 선호할 수 있습니다. CAD 커널은 도구마다 다르며, 스크립트는 그것을 실행한 도구와 버전 안에서만 재현됩니다. 다른 사람과 교환하려면 하류 CAD용으로 STEP을, 출력용으로 메시 형식을 내보내세요. 다음 장들에서 그 형식을 다룹니다.

생성적 설계​

"생성적 설계"는 목표와 제약 조건에서 형상을 제안하는 알고리즘을 아우릅니다. 가장 잘 문서화된 오픈 사례는 위상 최적화(topology optimisation)입니다. 하중, 지지 조건, 재료 예산이 주어졌을 때 재료가 어디에 있어야 하는지 찾는 것입니다. 이 방법은 1988년의 균질화 기반 정식화로 거슬러 올라가며 [12], 이후의 리뷰가 주요 접근법 계열을 비교합니다 [13]. 널리 알려진 공개 교육용 구현은 "88줄" MATLAB 프로그램으로, Sigmund의 더 이른 99줄 코드 [14]를 확장하고 빠르게 만든 후속작이며, 저자들은 7,500개 요소 문제에서 100배 빨라졌다고 보고한 벤치마크와 함께 발표했습니다 [15]. 한 번에 읽을 만큼 짧고, 핵심 교훈도 보여 줍니다. 최적화기가 돌려주는 것은 CAD 모델이 아니라 밀도 필드라는 점입니다. 누군가는 그것을 매끄럽고 출력 가능한 형상으로 바꾸고, 검증하고, 서포트와 후처리까지 설계해야 합니다. 이후 연구는 제조 제약을 최적화 자체에 넣었습니다. 예를 들어 설계만으로 희생 서포트 재료를 없애려는 오버행 제약 [16]과 출력 가능한 설계를 얻기 위한 필터 [17]가 있으며, 둘 다 시험하지는 않았습니다.

위의 셸 반복문 같은 매개변수 스윕은 더 단순한 일상의 사촌입니다. 하나의 레시피에서 여러 변형을 만들고, 각각 평가하고, 가장 좋은 것을 고릅니다. 이 장을 위해 오픈소스 위상 최적화 도구는 시험하지 않았으며, 특정 도구를 추천하지 않습니다.

왜 중요한가​

설계가 코드이면 검토하고, 시험하고, 공유하고, 고객에 맞게 매개변수화하고, 수년 뒤에도 다시 빌드할 수 있습니다. 오픈소스 소프트웨어를 성공시킨 바로 그 성질을 물리적 부품에 적용한 것입니다.

실제 현장에서는​

많은 오픈 하드웨어 프린터가 부품을 STEP이나 STL로 공개하고, 일부 프로젝트는 다른 사람이 개조할 수 있도록 OpenSCAD나 Python 소스를 공개합니다. 다른 사람이 만든 부품의 치수만 조금 바꾸면 된다면, 메시보다 매개변수형 소스가 훨씬 수정하기 쉽습니다.

핵심 용어​

  • 매개변수형 설계(Parametric design) — 이름 붙은 매개변수로 정의된 모델. 값을 바꾸면 형상이 다시 빌드됨.
  • CSG(constructive solid geometry) — 합집합, 차집합, 교집합으로 기본 형상을 조합해 솔리드를 만드는 방식.
  • B-rep(boundary representation) — 삼각형이 아닌 정확한 경계면으로 솔리드를 기술하는 방식.
  • 메시(Mesh) — STL처럼 작은 삼각형 여러 개로 근사한 표면.
  • 암시적(F-rep) 모델 — 어떤 점이 안쪽인지를 함수 값으로 알려 주는 방식으로 정의한 형상.
  • 기하 커널(Geometry kernel) — OpenCASCADE처럼 기반이 되는 솔리드 모델링 수학을 수행하는 라이브러리.
  • 위상 최적화(Topology optimisation) — 주어진 하중과 제약에서 재료를 어디에 둘지 결정하는 알고리즘.
  • 매개변수 스윕(Parameter sweep) — 하나의 스크립트를 서로 다른 매개변수 값으로 실행해 여러 변형을 만드는 일.

다음 이야기​

모델은 파일로 CAD를 떠나고, 프린터는 작업과 기계를 관리하는 소프트웨어를 통해 그것을 받습니다. 다음은 호스트 소프트웨어와 프린트 팜입니다.