2D 도면 세트 → 파라메트릭 3D 모델
일반 방법론

0한 장 요약

도면 세트를 3D로 옮기는 일은 형상 작업이 아니라 좌표계 통일 작업이다. 뷰마다 따로 노는 로컬 좌표를 하나의 프로젝트 좌표로 묶고 나면, 나머지는 기계가 한다.

도면 세트 ─┬─ 기준점(datum)  ─→ 전 뷰 공통 Z (또는 X·Y)
           ├─ 뷰 분리        ─→ 뷰마다 로컬 (u,v)
           └─ 뷰 앵커        ─→ 프로젝트 (X,Y,Z)
                                    │
                          프로파일(폐곡선) · 원 · 개구부
                                    │
                    fit ─→ params.json ─→ build ─→ IR ─→ 백엔드(3D/IFC)
                              ↑ 사람은 여기만 만진다      ↓
                                                  부피·물량·규칙 검사

변하지 않는 규칙 12개

1. 게이트에 넣기 전에 「이 도면이 솔리드 대상인가」를 먼저 판정한다. 표기 치수를 숫자형/기호형으로 세고, 구조 윤곽이 닫히는지 본다. 기호 치수뿐이거나(L·β·θ·VAR) 윤곽이 안 닫히는 도면은 어느 게이트에서도 안 통과한다 — 교량 삽도 7장 중 6장이 그랬다. 이 판정은 몇 초면 된다.
2. 단위와 축척을 도면에서 되찾고 두 치수로 교차검증한다. DWG 모델단위는 도면군마다 다르고(1m vs 1mm), 도형마다 배율이 또 다를 수 있다(5.805배). 상수로 두면 모든 값이 조용히 배수만큼 틀린다 — 폐곡선도 부피도 정상으로 보인다.
3. 기준점을 먼저 확정한다. 형상보다 앞이다. 기준점 없이 뽑은 형상은 정합 단계에서 전부 다시 한다. 단, 기준선이 아예 없는 도면이 실재한다 — 그때는 검출을 끄고 뷰별 v0로 간다. 아무 선이나 자동으로 고르지 않는다.
4. 기준은 텍스트가 아니라 선에서 잡고, 도면 치수 2개 이상으로 교차검증한다. 라벨은 후보를 좁히는 힌트일 뿐이다.
5. 뷰 하나는 [좌표평면 · 반전 · 원점 · 축척 · 용도] 다섯 속성으로 서술된다. 도면 종류는 9가지지만 좌표평면은 XY·XZ·YZ 셋뿐 — 나머지 차이는 보는 방향(좌우 반전)이다. 종류마다 코드를 늘리지 마라.
6. 입면도·측면도로 솔리드를 만들지 않는다. 잘린 면이 아니라 투영 윤곽이라 깊이가 없다. 검증과 위치에만 쓴다.
7. 구간 배정표는 종방향 뷰에만 있다. 횡단면은 "그 지점의 모습"일 뿐 어디까지 유효한지 말해주지 않는다.
8. 뽑아낸 도형 목록에서 무엇을 쓸지 고를 때, 목록 순서가 아니라 치수로 지정한다. "2,700×2,750 인 것"처럼. 순서로 집으면 도면이 조금 바뀔 때 아무 말 없이 다른 도형을 집는다.
9. 손으로 적은 수를 넣지 않는다. 도면과의 끈이 없는 값은 도면이 바뀌어도 안 바뀌고, 파라미터로 올릴 자격도 없다.
10. 속을 파낼 때는 빈 곳 없이 꽉 찬 덩어리를 먼저 만들고, 거기서 뺀다. 외곽선이 오목하면 파인 자리에 애초에 재료가 없어 벽을 만들 수 없다. 빼는 솔리드는 한 번에 하나씩, 대상보다 조금 크게.
11. 의도와 결과를 따로 잰다. IR을 직접 평가한 부피와 백엔드 결과 부피를 대조해야 "우리가 틀렸나 툴이 흘렸나"가 갈린다.
12. 조용히 틀리느니 예외를 던진다. 못 찾거나 여럿이면 멈춘다. 자동 선택은 나중에 몇 시간짜리 추적으로 돌아온다.

1범위와 계층

1.1 입력과 출력

1.2 계층 — 무엇이 어디에 있어야 하는가

이 경계가 방법론의 뼈대다. 무너지면 두 번째 도면에서 파이프라인이 아니라 복사본이 생긴다.

2좌표계 · 원점 · datum

선형 구조물이면 X 원점을 측점에 맞추는 것이 유리하다(측점 0k000의 좌표를 프로젝트 원점으로). 그건 datum이 아니라 앵커 u0 로 준다 — 그 측점 선의 뷰 좌표를 u0에 넣고, frame.origin에 "측점 0k000"이라고 적어 근거를 남긴다. 대상 도면은 측점이 아니라 구조물 최좌단을 X=0으로 잡았다(u0: 1000). 부분 측점 기반 원점은 미검증 — 곡선 선형·구배와 함께 12장 항목이다. 교량은 11장을 볼 것.

2.1 프로젝트 좌표계를 먼저 선언한다

축 셋과 원점을 문장으로 적고 시작한다. 이걸 안 적으면 뷰마다 다른 해석이 섞인다.

frame: {
  x: '길이방향 (기점 → 종점)',
  y: '폭방향 (중심선이 0, 평면도 위쪽이 +)',
  z: '표고 (기준고가 0, 아래로 음수)',
  origin: '구조물 최좌단 × 중심선 × 기준고',
}

단위는 내부 mm 정수. 백엔드에 넘기기 직전에만 m로 나눈다. mm 정수 반올림이 DWG의 부동소수 노이즈(-500.00000000001455)를 자동으로 흡수한다. 반올림을 뒤로 미루면 boolean 단계에서 터진다. 검증

2.2 datum(Z=0 기준선) 검출 — 4단계

1. 라벨이 한 무리인지 먼저 본다. 신규 라벨 y를 정렬해 2m 이상 벌어진 곳에서 끊는다. 무리가 둘 이상이면 공통 기준선이 없는 도면이므로 여기서 예외를 던진다. 아래 2단계의 숨은 전제가 바로 이것이다.
2. 후보 수집. 여러 뷰에 반복해서 나타나는 수평선(또는 수직 그리드선)을 모은다. 출현 횟수는 잡음 문턱으로만 쓴다.
3. 라벨 근접으로 확정. 후보가 둘 이상이면(계획고는 보통 도로/토공 두 줄이다) 라벨 바로 아래·옆의 선을 고른다. 라벨은 자기 선을 가리킨다.
4. 선에서 값을 읽는다. 텍스트 삽입점이 아니다. 실제로 713mm 틀렸다.
5. 도면 치수 2개 이상과 대조. 하나만 두면 우연히 맞을 수 있다. 하나라도 어긋나면 datum이 틀린 것이므로 다음 단계로 가지 않는다.

교량 계획고 → y=54,885.8
토공 계획고 → y=54,885.8      ← 정의상 다른 표고인데 같은 답
라벨별 국소 선 → 9개가 전부 다르다. 54,885.8 은 그중 어느 것도 아니다

datum: {
  levelLabel: /도로\s*계획고/,          // 후보를 좁히는 힌트
  checks: [                             // 최소 2개. 도면에 적힌 치수를 그대로
    ['B-B 구체 상단', (v) => v['단 면 B-B']?.layerZ['-전력구']?.[1], -4907],
    ['B-B 기초 하단', (v) => v['단 면 B-B']?.layerZ['!-기초']?.[0],  -7757],
  ],
}

3뷰의 일반 모델

도면 한 장을 3D 공간에 스티커처럼 붙인다고 보면 된다. 붙이려면 네 가지를 알아야 한다.

XY면 ← 평면도 · 저면도 · 수평단면
XZ면 ← 정면도 · 배면도 · 종단면
YZ면 ← 좌측면도 · 우측면도 · 횡단면

3.1 뷰 → 평면 대응표

3.2 뷰 역할 — 무엇을 주는 뷰인가

평면만 정해서는 부족하다. 같은 XZ 평면이라도 종단면과 정면도가 하는 일이 전혀 다르다. 역할을 배정하지 않으면 입면도로 압출하는 사고가 난다.

3.3 앵커와 flip 판정 절차 검증

뷰 안의 좌표는 뷰 좌단이 0인 u와 기준고가 0인 v다. 프로젝트 축으로 옮기려면 뷰마다 "어느 u가 프로젝트 0인가"를 정해야 한다. 투상법(1각/3각)을 가정하지 마라 — 도면마다 다르고, 틀려도 치수만 보는 동안은 안 걸린다.

1. 뷰 폭·높이를 도면 표기 치수와 대조. 여기가 안 맞으면 뷰 분리부터 틀린 것이다.
2. 앵커를 지어내지 말고 유도한다. 예: 뷰 세로 범위 −11,678~−1,478이 전폭 10,200이고 아래 끝이 Y=−1,900이면 v0 = -11,678 + 1,900 = -9,778.
3. 비대칭 특징 하나로 flip을 판정한다. 중심선 대칭 형상만 보면 뒤집힘이 안 드러난다. 샤프트·개구부·노치처럼 한쪽에만 있는 것을 고른다.
4. 다른 뷰에서 이미 확정한 좌표와 교차검증. 최소 2개. 세 개면 확정이다.

// 실제로 이렇게 확정했다 — 셋이 동시에 맞으면 앵커는 틀릴 수 없다
샤프트 사각 1,300×1,300   v -10,428..-9,128 → Y -650..+650     중심선 대칭 ✓
Ø900 보어 2개             v -9,778          → Y 0               ✓
맨홀 내부 2,000×7,200     v -11,278..-4,078 → Y -1,500..5,700   ✓

축을 뒤집거나 맞바꾸면 감김 방향이 반대가 된다. 뒤집기 횟수가 홀수면 꼭짓점 순서를 되돌려 면적을 양수로 유지한다. 코어가 자동으로 하지만, 새 평면을 추가할 때 잊기 쉬운 자리다.

3.4 뷰 분리 알고리즘 부분

여러 뷰가 한 모델스페이스에 나열돼 있으면 먼저 갈라야 한다. 간격 임계값 하나로는 절대 안 된다 — 넓게 잡으면 이웃이 딸려오고 좁게 잡으면 한 뷰가 쪼개진다. 둘 다 실제로 터졌다.

제목이 있고 간격이 있는 도면에서는 아래가 여전히 최선이다 — 좌표를 설정에 적지 않아도 되기 때문이다.

1. 구조 레이어 기하만 모은다 (넉넉한 struct 정규식)
2. x ↔ y 를 번갈아 가며 더 이상 갈라지지 않을 때까지 잘게 쪼갠다 (임계 0.2m)
   ↳ y로 나눈 뒤에야 드러나는 x 간격이 있다. 한 번씩만 하면 부족하다
3. 조각마다 "바로 위에 있는 표제"를 찾아 귀속시킨다
4. 같은 표제를 가진 조각끼리 합치면 그게 뷰다

4절차 — 11개 게이트

3D부터 세우면 어디가 틀렸는지 알 수 없다. 아래 순서를 건너뛰지 않는다. 각 게이트는 통과 기준이 있고, 실패하면 그 자리에서 멈춘다.

4.1 새 도면 인테이크에서 실제로 드는 시간

4.2 그림으로 읽는다 — 기하가 못 주는 의미

기하 파싱은 "이 선이 무엇인지" 모른다. 구체 외곽선인지 치수보조선인지, 여기가 벽인지 개구인지 좌표만으로는 안 갈린다. 실제로 맨홀 좌측 X=15,400 이 벽인지 개구인지 선만 보고는 판정이 안 됐다. 사람은 그림을 보면 즉시 안다.

그래서 그림과 좌표를 한 쌍으로 묶는다. 이게 조립(5장) 판단의 재료다 — 조립이 "사람 판단이 들어가는 유일한 자리"인데, 그 판단을 그림 없이 하면 추측이 된다.

          ①캡처                    ②사이드카                ③조회
도면 ────────────→ 이미지 ──── 픽셀↔좌표 변환 ────→ 프로젝트 mm ────→ 엔티티·링·레이어
                     ↑                                                      │
                     └──────────── ④오버레이(추출 결과를 그림 위에) ─────────┘

사람: 이미지에 표시  →  ②로 좌표 확정  →  ③으로 "그 자리에 무슨 엔티티가 있나"

캡처 규칙 셋

사이드카 — 그림과 좌표를 잇는 다리

{ "view": "단 면 B-B", "kind": "cross",
  "image": { "w": 1675, "h": 1388 },
  "originDwg": [-48351.647, 483619.770],   // 이미지 좌상단 픽셀의 도면 좌표
  "unitsPerPx": 0.004,                     // 내가 정한 값 (역산 아님)
  "yFlipped": true,                        // 화면 y는 아래로, 도면 y는 위로
  "datumY": 483623.477,                    // 프로젝트 Z=0
  "viewLeftDwgX": -48350.447,              // 뷰 좌단 = 로컬 u=0
  "anchor": { "u0": 2150 },
  "howTo": [ "dwgX = originDwg[0] + px * unitsPerPx",
             "dwgY = originDwg[1] - py * unitsPerPx",
             "u(mm) = round((dwgX - viewLeftDwgX) * 1000)",
             "z(mm) = round((dwgY - datumY) * 1000)",
             "프로젝트 좌표 = anchor 적용 (u0/v0/flip/swapUV)" ] }

지금 되는 것 / 없는 것

③′와 ④가 다음에 만들 것이다. 둘이 있으면 왕복이 닫힌다 — 사람이 그림에 표시 → 엔티티 확정 → 설정 한 줄 수정 → 다시 그림으로 확인. 지금은 ③에서 목록을 눈으로 훑느라 끊긴다.

3D 렌더도 같은 축척 규칙으로 뽑아야 도면과 나란히 놓고 대조된다. 입면도·측면도 검증(3.2 validator)이 붙는 자리가 여기다.

5조립 스펙(IR) — 사람 판단이 들어가는 유일한 자리

5.1 IR 연산

5.2 연산 결정 트리

이 형상을 어떻게 만들까?

┌ 단면이 구간 내내 같은가?
│   예 → extrude.  압출축 = 단면 평면의 법선
│   아니오 ↓
├ 두 지점 사이에서 선형으로 변하는가?
│   예 → loft.  ★ 꺾이는 자리마다 단면을 놓고 구간을 끊는다
│   아니오 ↓
├ 축이 곡선이거나 구배가 있는가?
│   예 → sweep (미구현). 지금은 구간을 잘게 끊어 loft/extrude로 근사
│   아니오 ↓
├ 원형 관통·기둥인가?
│   예 → cylinder.  지름으로 집는다. 선분과 섞지 않는다
│   아니오 ↓
└ 층 구조가 수평 단면들로 주어지는가?
    예 → 층별 XY 프로파일을 Z로 쌓아 union (조각이 Z로 진짜 겹치게)

5.3 조립 5원칙

loop('단 면 B-B', 2700, 2750).ring
circles('평 면 도', 900, /^-전력구$/)
opening('단 면 H-H', 1200, 2000)

shell = 오목한 외곽 압출
fill  = 파인 면 압출        ← 폐곡선 추출이 이미 뽑아준 면
solid = union(shell, fill)  ← 여기서 비로소 꽉 찬다
body  = solid − 공동들      ← 이제 벽이 남는다

5.4 압출축과 벽 방향 검증

YZ 단면을 X축으로 밀면 → Y 방향 벽만 생긴다. X 방향은 열린다
XZ 단면을 Y축으로 밀면 → X 방향 벽만 생긴다. Y 방향은 열린다

나머지 방향 벽은 두 단면을 교집합할 필요 없이 공동의 압출 범위를 좁혀서 만든다. 외곽은 전 구간을 채우고 공동만 안쪽으로 줄이면 앞뒤로 벽이 남는다. 공동의 끝이 솔리드 내부라 면이 겹치지 않아 여유도 필요 없다.

단면이 어느 평면인지는 절단 기호가 결정한다. 절단선 양끝 두 점의 x가 같으면 YZ, y가 같으면 XZ다. 폭 치수만으로는 구분이 안 되는 경우가 있다(X도 2,600, Y도 2,600).

5.5 프로파일이 못 쓸 때 — bbox 재구성

링은 못 믿어도 bbox는 믿을 수 있다. 형상이 직사각형이라는 걸 알면 bbox만으로 복원된다. 단, expect()를 남겨 도면과의 끈을 유지한다 — 값이 어긋나면 거기서 걸린다.

expect('단 면 H-H', 1200, 2000, '환기 OPEN부 (2.0x1.2)');   // 실재 확인만
profile('mh.ventHole', 'XY', rect(15800, -500, 17000, 1500)); // 실제 프로파일

오목한 외곽은 rect()로 못 만든다. 그때는 X자 교차 분할이 필요하거나, 수평 단면에서 층별로 다시 세우는 쪽이 낫다.

6파라메트릭화

DWG ──fit──→ params/<이름>.json ──build --params──→ IR ──→ 3D
              ↑ 사람은 여기만 만진다.   build 는 도면을 안 본다

6.1 값 하나의 생김새

{
  "구체_외폭": { "v": 3800, "src": "measured", "from": "단 면 C-C 외곽 폭",
                "fitted": 3800, "grade": "exact" },
  "벽두께":    { "v": 400,  "src": "design", "min": 300, "max": 600, "step": 50 },
  "구체_내폭": { "expr": "구체_외폭 - 2*벽두께" },
  "샤프트":    [ { "no":1, "x0":1900, "x1":3200 }, { "no":2, … } ]
}

6.2 재현 등급 — 파라미터로 못 만드는 형상 다루기 검증

프로파일을 파라미터로 "생성"하면 도면의 실제 형상을 잃는다. 50mm 보도 단차 같은 자잘한 것이 생성기로 재현이 안 되면 조용히 빠진다. 그래서 완전일치를 요구하지 않고 등급을 매긴다.

opaque가 핵심이다. "재현 못 하면 파라미터화 안 한다"가 아니라 "재현 못 하는 링은 값으로 얼려 넣는다". 그러면 build가 도면을 안 봐도 되면서 자잘한 형상이 빠지지도 않는다. 그 링은 못 바꾸는 것일 뿐이고, 그게 정직하다. 등급 분포가 곧 "이 도면이 얼마나 파라메트릭한가"의 척도다 (대상 도면: opaque 8 · exact 2 · tolerant 1).

6.3 파라미터로 올릴 자격 검증

6.4 규칙 층 — 폼과 도구를 가르는 것

규칙은 부재 종류에 붙는 것이지 도면에 붙는 게 아니다. 도면별 예외가 필요하면 문턱 자체를 파라미터로 노출한다. 모델러까지 가서 비틀린 면으로 만나는 것보다 훨씬 싸다.

6.5 편집 UI는 얇다 검증

build --params → emit → run --reset --export → measure --ir → render --dims

파이프가 이미 CLI 단계 사슬이라 UI가 한 일은 params 편집 + 그 사슬 순서대로 실행뿐이다. min/max/step이 그대로 입력 위젯이 됐고 src는 태그, fitted는 변경 표시가 됐다. 갱신 버튼이 검증을 태워야 도구가 된다 — 단순 실행이면 폼이다.

7검증 체계

7.1 의도와 결과를 따로 잰다 검증

부피가 이상할 때 물어야 할 것은 둘이다. 이걸 못 가르면 엉뚱한 데를 판다 — 실제로 손으로 기대값을 세 번 조립했는데 세 번 다 커터 범위를 놓쳐 틀렸고, 그 값으로 모델러를 의심하며 시간을 버렸다.

우리 조립(IR)이 틀렸나?         ← 의도 : IR을 격자로 CSG 평가 (모델러 없이)
백엔드가 IR대로 안 만들었나?     ← 결과 : OBJ 삼각형을 발산 정리로 실측

파트                    부피 m³     IR 의도       차이
전력구_구체             100.5403   100.5350     0.0053 ✓
맨홀2_구체               65.3577    74.6819    −9.3242 ✗  ← 여기만 백엔드가 흘렸다

격자 평가는 25mm 격자에서 0.1% 안팎이라 소수 셋째 자리는 못 보지만, boolean이 죽는 사고는 언제나 m³ 단위로 어긋나므로 충분하다.

7.2 이상 신호 우선순위

7.3 기대값은 자동으로 안 나온다 — 그리고 그게 맞다

커터는 관통을 확실히 하려고 대상 밖으로 튀어나와 있고 공동끼리 겹치기도 한다. 그래서 Σ멤버도 base − Σ커터도 틀린 값이 된다. 틀린 기대값은 기대값이 없는 것보다 나쁘다. 새 형상의 기대값은 원시 파트 부피표를 재료로 사람이 한 번 조립하고, 맞으면 기준선으로 얼린다.

두 단면 사이 면적은 t의 2차식이므로 심프슨 V = L·(A0 + 4·A(½) + A1)/6이 근사가 아니라 정확하다. loft 검산에 그대로 쓴다.

7.4 그림으로 보는 검증 검증

• 추출 결과 뷰어 — 뷰별 링을 SVG로 그리고 자기교차·꼭짓점 수·원·IR·부피를 한 장에. 숫자로 반나절 걸린 원인이 그림에서는 빨간 X 두 개로 즉시 보였다.
• 도면 캡처 + 좌표 사이드카 — 픽셀↔도면 좌표 변환을 JSON으로 같이 떨군다. 이미지에서 짚은 지점이 곧 프로젝트 좌표가 된다.
• 3D 정투영 렌더 — 만든 모델을 X·Y·Z로 투영. 입면도·측면도 대조가 여기 붙는다(3.2의 validator 역할).
• 치수선 렌더 — 파라미터를 가리키는 치수선을 렌더에 얹는다. 2D 도면이 치수로 형상을 증명하듯이.

8함정 사전

전부 실제로 밟은 것이다. 증상 → 원인 → 대응 순.

8.1 도면·데이터

8.2 좌표·뷰

8.3 프로파일

8.4 조립

8.5 백엔드(모델러)

백엔드 특이사항은 전부 emit/ 안에 가둔다. 아래는 EGModeler 사례지만, 다른 툴로 바꿔도 같은 성격의 함정이 그 자리에 온다.

9새 도면 인테이크 워크시트

9.1 채워야 할 것 (순서대로)

1. 도면 적격 판정 먼저 — 표기 치수를 숫자형/기호형으로 세고, 구조 윤곽이 닫히는지 본다. 기호뿐이거나 안 닫히면 솔리드 대상이 아니다. 여기서 걸러야 나머지 아홉 항목을 헛되이 채우지 않는다
2. 모델단위 — DIMENSION.actualMeasurement ↔ 치수 글자를 비교해 unitMm 확정. 도면군마다 다르다
3. 구조물 종류·좌표계 선언 — X·Y·Z 방향과 원점을 문장으로
4. 시트 영역 — 전체 좌표 분포를 히스토그램으로 보고 유령 기하를 가른다
5. 레이어 4갈래 — struct(넓게) / body(좁게) / material / ground. body ⊆ struct. 레이어가 구조선과 치수선을 안 가르면 색·선종으로 거른다(entityFilter)
6. 표제 글자 높이 분포 — 시트명 / 뷰 제목 / 부재 라벨의 h를 세어 minHeight 결정. 표제 중복률도 같이 센다 — 높으면 제목으로 뷰를 못 가른다
7. 뷰 목록 — 제목 → {plane, flip, role}. 단면은 절단 기호 좌표로 평면 판정. 제목이 없거나 중복이면 viewBoxes로 좌표를 짚는다
8. 기준점 — 라벨 정규식 + 도면 치수 검증 2개 이상. 기준선이 없으면 mode:'none'으로 명시하고 검증을 G5로 미룬다
9. 앵커 — 뷰별 u0/v0/flip/flipV/swapUV/unitMm. 비대칭 특징으로 교차검증. 축척이 다르면 표기 치수 2개로 역산해 교차검증한다
10. 구간 배정표 — 종방향 뷰에서 X 범위 × 단면 대응
11. 조립 스펙 — 5장의 결정 트리와 5원칙
12. 규칙 — 이 부재 종류의 위상 규칙 · 설계 기준

9.2 설정 파일 스켈레톤

export default {
  name: '<도면이름>',
  dwg: path.join(DRAWINGS_SRC, '<파일>.dwg'),

  // 이 밖의 좌표는 버린다 (유령 기하 · 블록 로컬 좌표)
  sheet: { x0: …, x1: …, y0: …, y1: … },

  // DWG 1단위가 몇 mm인가. **도면군마다 다르다** (맨홀군 1000, 교량 삽도군 1).
  // DIMENSION.actualMeasurement 와 치수 글자를 비교해 확정한다.
  unitMm: 1000,

  // 레이어로 못 가르는 것을 거른다. colorIndex 0 = ByBlock = 치수 블록 안.
  // 구조선과 치수선이 같은 레이어인 도면에서만 쓴다.
  entityFilter: (e) => (e.entityHeader?.colorIndex ?? -1) === 7,

  layers: {
    struct:   /…/,   // 뷰 분리용. 넉넉하게 — 가구·주기가 들어가도 된다
    body:     /…/,   // 프로파일용. 좁게 — 가구가 섞이면 링이 오염된다
    material: /…/,   // 기초·잡석 등 별개 재료. 추출엔 함께 넣는다
    ground:   /…/,   // 기준선(계획고·GL·FL) 검출용
  },

  titles: {
    minHeight: 0.32,             // 부재 라벨과 뷰 제목을 가르는 글자 높이
    views: {
      '평 면 도':  'plan',        // → XY
      '단 면 A-A': 'long',        // → XZ  (절단 기호 두 점의 y가 같다)
      '단 면 B-B': 'cross',       // → YZ  (두 점의 x가 같다)
      '단 면 H-H': 'horizontal',  // → XY  (다른 단면 위에 찍힌 수평 절단)
      // 입면도·측면도를 넣을 때: 평면은 XZ/YZ지만 role은 validator다.
      // 절단면이 아니므로 여기서 프로파일을 뽑아 압출하면 안 된다.
    },
  },

  segment: { gap: 0.2, xTol: 0.5, ySlack: 0.2 },   // 단위는 DWG 단위다 (unitMm 에 맞춘다)

  // 제목이 없거나 중복이면 **좌표로 짚는다**. titles.views 와 둘 중 하나만 쓴다.
  // y 값은 눈대중이 아니라 구조선 좌표 뭉치의 경계에서 뽑고, 상자는 그 빈틈 안에 둔다.
  viewBoxes: {
    '<뷰>': { box: [x0, y0, x1, y1], kind: 'cross',
              unitMm: 1 / 5.805 },   // 도형마다 축척이 다르면 여기서 준다
  },

  datum: {
    mode: 'none',                // 기준선이 도면에 없을 때. 표고는 뷰별 v0 가 준다
    levelLabel: /…/,             // 기준선 후보를 좁히는 힌트. 값은 선에서
    checks: [                    // 최소 2개. 도면에 적힌 치수 그대로
      ['<설명>', (v) => v['<뷰>']?.layerZ['<레이어>']?.[1], -0000],
    ],
  },

  frame:  { x: '…', y: '…', z: '…', origin: '…' },

  anchors: {                     // 유도하고 교차검증한다. 지어내지 않는다
    '평 면 도':  { u0: …, v0: … },        // 평면도도 v0가 필요하다
    '단 면 B-B': { u0: … },                // 수직 단면은 v가 이미 표고
    '단 면 H-H': { u0: …, v0: …, swapUV: true },
  },

  expectExtents: { '<뷰>': [폭, 높이] },   // 분리 자동 확인

  fit({ loop, circles, opening, expect }) {
    // 도면을 보는 **유일한** 통로. 여기서 params.json이 나온다
    expect('<뷰>', 폭, 높이, '왜 이게 있어야 하는가');
    return { params: { … }, rings: { … } };
  },

  assemble({ p, ring, profile, part, rect }) {
    // 도면 조회 도우미를 주지 않는다 — 주면 다시 도면에 묶인다
  },
};

10도면 작성자에게 요청할 것

효과 대비 비용이 큰 순서. 1번 하나로 검출 로직 전체가 사라진다.

도면을 뷰별 파일로 쪼개달라고 하지는 말 것. 표고 정합과 절단기호 매핑을 같이 잃는다(3.4).

11구조물 유형별 차이

1~4장(정렬 · 뷰 · 게이트)과 7장(검증)은 구조물이 뭐든 안 바뀐다. 바뀌는 것은 좌표 기준과 쓰는 연산이다.

11.0 실증 결과 — 교량 도면 7장에서 실제로 일어난 일 검증

11.0.1 통과한 것 — 중앙분리대 방호벽

7장 중 닫힌 구조 단면을 가진 유일한 도면이었다. 세운 것은 토공용 구간 → 변화구간(2m) → 교량용 구간의 방호벽 한 줄이다.

단면A (토공용, 585×1319)  ──extrude X 0→5,000──┐
                                               ├─ loft 5,000→7,000  ← 변화구간
단면B (교량용, 584×1270)  ──extrude 7,000→12,000┘
                    union → 중앙분리대_방호벽

부피  모델러 4.8058 m³   IR 격자(25mm) 4.7970   해석 프리즈모이드 4.8058
modelCount 1 = 최종 파트 수 1

• 축척을 되찾아야 했다. 이 단면은 5.805배로 그려져 있다. 표기 치수 2개(높이 1,270 · 바닥폭 585)로 역산해 교차검증했다 — 차이 0.06%
• 두 단면의 기준면 y가 달랐다. 포장면 48,812.1 vs 바닥판면 49,096.5. 그 차이가 곧 「토공용은 포장에 49mm 묻힌다」는 형상이었다
• difference가 하나도 없는 첫 모델. 방호벽은 속이 찬 콘크리트다. 뺄 게 없으니 boolean 함정(8.4)이 통째로 안 나왔다 — 즉 8.4는 아직 교량에서 검증되지 않았다
• loft 하나로 끝났다. 변화구간이 실제로 직선 전이(꺾이는 자리 없음)였기 때문이다. 교훈 #16(꺾이면 끊는다)이 여기서는 해당 없었다

11.0.3 교량 상부공 — 폐곡선 버그를 고치자 나왔다

교량폭원은 처음에 G5에서 죽었다 — 끊김 56곳 중 54곳이 「도면에 선 없음」이었다. 그런데 겹치는 동일선상 선분 버그(8.3)를 고치고 다시 돌리자 폐곡선이 새로 나왔다. 「도면이 안 닫는다」의 상당 부분이 실은 우리가 못 닫은 것이었다. 판정을 내리기 전에 도구부터 의심할 것.

폭원 띠 상    24,300 × 240   바닥판 전폭   ↔ 도면 표기 24,300
분리교량      12,300 × 240 · 15,900 × 240   좌·우 상판
                 440 × 1,320 ×3            방호울타리
              11,400 ×  50   마모층        ↔ 도면 표기 11,400 (도로 폭)

서로 다른 삽도가 같은 값을 준다. 유형 삽도 묶음은 좌표가 물려 있지 않아 뷰 사이 교차검증이 안 된다고 봤는데(11.0), 치수 값 수준에서는 물려 있다. 공통 datum이 없는 도면군에서 쓸 수 있는 교차검증 경로가 이것이다.

세운 것: 좌·우 상판 · 마모층 · 방호울타리 4기를 경간 20m(설계값)로 직선 압출. 7파트 180.356 m³, 의도 대비 전부 0.0000. 넷째 방호울타리는 도면 윤곽이 안 닫혀 재구성했다 — 들임(10mm) 규칙을 측정된 두 부재로 확인한 뒤 적용했고, 그렇게 놓은 외면 좌표가 gaps가 짚은 끊김 좌표와 같은 값으로 떨어지는 것이 검증이다. 등급은 tolerant — 도면 좌표를 옮긴 게 아니라 만든 것이므로 opaque가 아니다.

11.0.4 교량 한 기 — 「표기 치수 0개」를 잘못 잘랐다

1:1 인지는 크기를 아는 표준 부재로 확정했다. 도면 밖에서 온 눈금이다.

폐곡선 153×182 이 4개    ← 탄성받침 150×180. 다른 게 이 치수로 4개 나란할 이유가 없다
교대 벽체 4,680×6,506     교량 교대 자릿수
상부공 형고 1,421         지간 12,752 에 L/h≈9 — 반일체식으로 타당
접속슬래브 두께 383        표준 300~400

넷이 **동시에** 타당해지는 배율은 1 뿐이다. 10배만 달라도 받침이 1.5 m 나 15 mm 가 된다.

그 도면 하나로 2지간 교량 한 기가 열렸다 — 이 도면군에서 하부공이 부재로 그려진 유일한 도면이다.

바닥판 26,178×277 · 거더 12,303/12,748×1,144 ×5본씩
교대(벽체+확대기초) 4,680×7,953 ×2 · 날개벽 4,563×6,932 ×4
교각 두부 2,244×1,334 · 기둥 1,586×3,904 · 확대기초 5,081×1,334
교좌받침 153×182 ×8열 · 받침콘크리트 ×3 · 접속슬래브 3,705×383 ×2
말뚝 Ø518 ×10위치 (연직이라 IR 의 Z축 cylinder 가 그대로 맞았다)

95파트 · 820.36 m³ · 의도 대비 전부 0.0000

11.0.5 도면이 정보를 주는 방식 — 형상만이 아니다

형상이 없다고 정보가 없는 게 아니다. 개구 기호를 되살린 것과 같은 종류의 이득이 중심선·해치에 남아 있다. circles() 를 만든 것과 같은 이유로 centerlines() 가 필요하다.

11.0.2 범위에서 뺀 것 — 명시

11.1 교량 — 기준이 하나가 아니라 체인이다 가설

전력구는 프로젝트 원점 하나로 전부 기술된다. 교량은 안 된다. 상부공은 선형을 타고(곡선·편경사로 기울어짐) 하부공은 연직으로 선다. 두 좌표계가 다르므로 잇는 지점이 필요하고, 그 지점이 교좌받침이다.

프로젝트 원점
  └─ 선형 (측점 s · 오프셋 t · 표고)          ← 상부공은 전부 여기서 나온다
       └─ 받침 (측점 + 오프셋 + 받침표고)      ← 두 좌표계를 잇는 유일한 접점
            └─ 교각 로컬 (연직 · 사각)         ← 하부공은 전부 여기서 나온다
                 └─ 기초 · 말뚝 배치 격자

도면이 이미 이렇게 기술한다 — 하부공 도면은 받침 중심 좌표와 받침 표고로 교각을 잡고, 거기서 아래로 교각·확대기초·말뚝을 내린다. 그래서 받침을 앵커로 삼는 것이 도면을 그대로 옮기는 것이 된다. 받침을 안 쓰고 절대좌표로 잡으면 사각(skew)·편경사가 들어오는 순간 값이 전부 손계산이 된다.

11.2 교량에 필요한 확장

11.3 교량에서는 측면도의 지위가 다르다 부분

3.2에서 입면도·측면도는 검증(validator) 역할로 못박았다. 교량에서도 솔리드를 만들면 안 되는 것은 같지만, 교량 일반도의 측면도는 구간 배정표(assigner)를 겸한다 — 경간 분할 · 교각 위치 · 형고 변화 · 받침 표고가 전부 거기 있다. 전력구에서 종단면이 하던 일을 교량에서는 측면도가 한다.

11.4 삽도(유형 도해)는 별도의 구조물 유형이다 검증

일반도와 삽도는 같은 파이프라인으로 다룰 수 없다. 표로 갈라둔다.

11.4 실증 결과 — 교각 P9 한 부재를 끝까지 검증

파트 77 · 660.4154 m³ · 모델러 실측 대비 불일치 0건 · 열린 변 0
  코핑 1(intersect) · 원형기둥 2 · 확대기초 2 · 버림 2 · 강관말뚝 44
  받침콘크리트 6 · 모르타르 6 · 교좌받침 6 · 솔플레이트 6 · 미관문양 2

구체 콘크리트 fck=27MPa   359.3411      미관 문양            3.3585
기초 콘크리트 fck=27MPa   177.4500      받침콘크리트          1.8438
강관말뚝 Φ508.0×9T       108.7954      탄성받침             0.3469
버림 CON'C fck=15MPa       8.9780      무수축 모르타르        0.1555
                                       솔플레이트            0.1299

11.4.1 방법론 판정 — 「해봤다」가 아니라 참/거짓으로

11.4.2 도면이 정보를 주는 방식 — 표가 추가됐다

11.4.3 세 갈래가 서로를 검산한다

형상 · 표 · 다른 도면이 같은 값을 서로 다른 길로 낸다. fit() 이 매번 확인하고 어긋나면 던진다.

11.4.4 파단선 — 이 도면 유형의 최대 함정 검증

11.4.5 코어에 새로 들어간 것

11.4.6 Loft 는 boolean 에 못 쓴다 — 가장 비싼 발견 검증

11.4.7 새로 밟은 함정

11.4.8 IFC 출력

node src/emit/ifc.mjs out/pier-p9.ir.json   →  out/pier-p9.ifc  (IFC4, 170 KB)

IFCBEAM 1(코핑) · IFCCOLUMN 2 · IFCFOOTING 4 · IFCPILE 44
IFCPLATE 6(솔플레이트) · IFCDISCRETEACCESSORY 6(받침) · IFCBUILDINGELEMENTPROXY 14

해석 솔리드를 우선한다. 원기둥은 IfcCircleProfileDef 로 나가 진짜 원이다 — 메시로 내면 검증하는 쪽이 「왜 Ø508 이 아니냐」를 다시 겪는다. boolean 결과(코핑·문양 2)만 이미 검증된 IfcFacetedBrep 이다.

절대 위치는 IfcMapConversion 으로 준다. 모델은 로컬 원점에 두고 좌표를 3억 mm 로 부풀리지 않는다 — 뷰어가 정밀도를 잃는다.

12미검증 영역 — 다음 도면에서 확인할 것

실증하며 채울 목록. 각 항목에 확인 방법과 예상 대응을 미리 적어뒀다.

12.1 실증할 때 기록할 것

• 어느 게이트에서 몇 번 막혔는가 — 방법론의 약한 고리다
• 설정으로 해결됐는가, 코드 수정이 필요했는가 — 후자면 코어에 도면 고유값이 샌 것
• 등급 분포(exact/tolerant/opaque) — 생성기가 얼마나 부족한지의 척도
• 새로 나온 함정 — 증상·원인·대응 3열로 8장에 추가
• 이 문서에서 틀린 것 — 표본 하나로 일반화한 자리가 어디였는지

13용어·필드 사전

13.1 뷰 스펙

13.2 도면 조회 도우미 — fit()만 쓴다

13.3 등급·출처