Pier_v1/CLAUDE_rhino배경.md

프로젝트 배경 (자동 로드 — Claude Code가 세션 시작 시 항상 읽음)

이 파일은 라이노(Rhino) 작업 배경과 규칙을 정리한 것입니다. 새 작업을 시작하기 전에 아래 구조 정보와 컨벤션/규칙을 항상 따르세요.

0. 설계기준 (모든 프로젝트 공통 · 최우선 기본 원칙)

• 기준 문서: KDS 24 14 21 : 2025 콘크리트교 설계기준(한계상태설계법) — D:\★Pier 자료\KDS 24 14 21 콘크리트교 설계기준(한계상태설계법).hwp (2025.08.22 개정). 모든 프로젝트(대호지교, 평강1교 등)의 배근·상세는 이 기준을 따른다.
• 읽는 법: HWP 텍스트(수식 포함) 추출본 D:\★Pier 자료\pier_v1\Pier_T_rebar\Code\rebar_pipeline\kds\KDS_24_14_21.txt (추출기 kds\hwp2txt.js, Node.js). 조항 번호로 grep 해서 읽을 것 (예: 4.4.4 피복, 4.5.2 구부리기, 4.5.3 간격, 4.5.4 정착·갈고리, 4.5.5 이음, 4.6.2 보/전단철근/표피철근).
• 이 기준과 다르게 배근된 철근이 있으면 철근재료표 비고란에 별도 색상(자홍 62=6)으로 내용을 적는다 (rebar_pipeline\dxf\kds_note_column.ps1, 열 이름 "비고 3 (KDS 24 14 21 기준 상이)").
• 주요 수치 (확인 완료): 이형철근 최소 내면지름 D16 이하 2db / D19 이상 3.5db(표 4.5-1) · 수평 순간격 ≥ max(1.5db, 1.5Gmax, 40mm), 다단 연직 순간격 ≥ max(25mm, db)·동일 연직면 · 표준갈고리 90°~150° 구부림 뒤 연장 ≥ 5db · 전단철근 종방향 간격 ≤ 0.75d(1+cotα), 폭방향 ≤ 0.75d·600mm, ρv,min = 0.08√fck/fy, 단면 내 50% 이상 폐쇄/U형 · 겹침이음 두 철근 횡방향 순거리 ≤ 4db·50mm · 피복: 최소피복 = max(부착 db, 환경 표 4.4-4) + 설계편차 10mm, 피복 > 70mm이면 표피철근(0.005Act,ext) 필요.
• DXF 도면이 모든 작업의 제1 기준 자료 (모든 프로젝트 공통, 2026-10-28 사용자 지시): 사용자가 주는 DXF 도면 파일이 배근·자료·모델 작성의 가장 기본 자료다. 도면(재료표·이형철근 상세 그림·치수)을 DXF 에서 직접 읽고, 필요한 그림은 DXF 를 렌더링해 잘라서 증거 이미지·대조 이미지에 넣는다(PNG 캡처·기억에 의존 금지). 도면을 잘 보고 오류 없이 배근한다. 도면 안에 오류가 있으면 엑셀에 도면↔도면 오류(도면 내부 불일치)와 도면↔모델 오류를 구분해 항상 기록한다.
• 구부림·갈고리 값은 KDS 24 14 21만 따른다 (표 4.5-1, 4.5.4.2). 건축용 기준(KDS 14 20 50)은 이 프로젝트에 맞지 않아 사용하지 않는다. 이미 모델링된 철근의 R=3db/4db는 과거 값이며 KDS 24 14 21 최소값보다 커서 위반은 아니다.

1. P1 교각 모델링 작업 (두부보 철근 작업)

• 실제 시공 도면(교각도, 두부보 도면) 기반으로 P1 교각 라이노 모델링 진행 중. (전체 세트: P1, P2, P10, P11, P12 중 하나)
• 구조: P1은 2주식 교각이며 별도 footing 없이, Phi3.0m 현장타설말뚝기둥 2개가 중심간격 13.0m로 배치되고, 말뚝 선단에서 두부보(코핑)까지 연속으로 이어지는 구조.
• 배치 기준: 말뚝좌표표의 실제 측량 좌표(좌측/우측 X, Y)와 실제 표고(H, H1, H2, 지반고, EL "CL"/"CR"/"PB")를 사용해 실제 좌표에 모델을 배치함.
• 현재 진행 상황: 두부보(cap beam) 철근 작업 시작 단계.
  • 재질: SD400
  • 철근 마크: C1~C26
  • 형상 범례(P1/P3/P5/P8 두부보 도면 기준): I~VIII (직선, 단곡, 양곡, 폐쇄 스터럽, 갈고리, 경사단부 등)

적용 설계기준 — 철근 구부림 최소 내면지름

• 기준: KDS 24 14 21 4.5.2.1 표 4.5-1 (철근 자체의 손상을 막기 위한 최소 내면 지름; 반지름 아님)
  • 이형철근: D16 이하 2db / D19 이상 3.5db (내면 반지름으로는 1db / 1.75db)
  • 원형철근: D16 이하 1.25db / D19 이상 2.5db
  • 구부린 철근 내부 콘크리트 손상 검토(식 4.5-1)는 4.5.2.1(3) 조건을 만족하면 생략 가능
• 표준갈고리 (4.5.4.2): 구부림 각도 90°~150°는 구부린 반원 끝에서 5db 이상 연장, 150° 이상도 5db 이상 연장
• Rhino 센터라인 필렛 반지름 = 내면 반지름 + db/2
• 새 모델링에 실제로 쓸 R값(기준 최소값 vs 기존 관행값)은 사용자 결정 사항 — [미확정]
• 이미 만든 모델(P1 두부보: H25 R=76.2mm, H29 R=114.4mm)은 기준 최소값보다 크므로 기준 위반이 아니다. 이 값은 과거 적용값일 뿐 기준이 아니다.
• KS D 3504 공칭 철근직경 (본 프로젝트 적용값): H16=15.9mm(주로 16mm로 반올림), H19=19.1mm, H22=22.2mm, H25=25.4mm, H29=28.6mm

공통 규칙 — 코핑부/두부보 철근 배근 (프로젝트 무관하게 항상 적용)

• 단차/경사진 코핑(또는 두부보) 상단을 지나는 주철근은 단순 직선으로 배치한다 (단마다 따라가지 않음) — 기준면의 가장 낮은 지점에서 피복 120mm를 측정하고, 철근 전체를 그 한 높이에 평평하게 유지한다.
• 일반도와 구조도는 항상 함께 대조 확인한다 — 두 도면 사이에 형상 관련 불일치가 있을 수 있으므로(예: 코핑 하부 헌치 형상), 한쪽만 보고 모델링하지 않는다.

2. P1 단면 작업 (Grasshopper 단면 추출)

• 라이노 8 + Grasshopper(rhino_mcp 경유)로 P1 기초(footing) + 버림콘크리트 모델 작업.
• 단면 추출 방법 컨벤션 (요청 시 번호로 지정):
  • "1번" = 수동 방식 — BrepPlane으로 곡선을 추출한 뒤, 직접 만든 2D 박스/프레임에 치수·라벨을 수기로 배치
  • "2번" = 라이노 네이티브 ClippingSections + ClippingDrawings 기능 — 3D 모델과 실시간으로 연동되고, UpdateClippingDrawings로 갱신 가능
  • "3번" = ClippingPlane 오브젝트로 3D 모델 위에서 바로 시각적으로 단면을 잘라보는 방식 (2D 곡선을 따로 추출하지 않음)

상시 규칙 (항상 지킬 것)

• 단면을 뽑을 때는 항상 3분할된 A1 프레임 박스의 가운데 칸에 배치한다.
• ClippingDrawings가 자동 생성하는 검은 이름 텍스트닷(AA, BB 등)은 항상 도면 박스 바깥으로 이동시킨다.
• 라이노에서 오브젝트를 삭제하기 전에는 항상 먼저 사용자에게 물어본다.
• 2단(2-tier) 치수 규칙:
  • 2단(외부/합계) 치수선은 1단에서 1000 떨어진 위치에 배치한다.
  • 화살표 아래쪽 인출선(leg) 세그먼트만 늘어난다 (하단 점 아래에 스텁을 수동으로 추가, 길이 = 1500 = 1:1 축척에서 15).
  • 화살표 위치와 위로 튀어나온 길이는 항상 현재 상태를 유지한다 (변경하지 않는다).

3. 평강1교(Pyeonggang 1 Bridge) P1 교각 모델링

• 별도의 새 프로젝트입니다 (위 1번 "P1 교각" 모델과는 다른 문서/파일이며, 더 큰 규모의 프로젝트).
• 참고 도면: 교각 구조도(1)(2)(3) (구조/철근 상세), 평강1교_일반도 (일반도)
• 구조: 2주식, Phi2500mm, 중심간격 14,860mm; 코핑(cap) 평면 25,860mm x 3,500mm; 재료표에 주철근 내측/외측이 구분되어 있어 중공(hollow) 기둥으로 추정
• 재료: 콘크리트 fck=35MPa; 철근 SD400(fy=400MPa); 설계하중 KL-510, 한계상태설계법
• 표고: 코핑 상단 EL 7.130(좌측)~6.426(우측, 받침점마다 다름), 기둥/말뚝 하단 EL -64.475, 전체 높이 약 71.6m (매우 높은 교각, 커플러로 장이음된 주철근 다수 — 예: H29 L=71.055m x112EA)
• 제공된 도면에 실측 X,Y 좌표표 없음 (기존 P1 교각 프로젝트와 다름) — 현재는 로컬 원점 기준으로 모델링
• 라이노 모델 파일명: "평강1교 test"
• 코핑 상단: 평평하지 않고 단차(캠버) 있음 — EL 7.130(좌측 끝)에서 EL 6.426(우측 끝)까지 8구간, 대부분 약 103mm 단차, 한 구간만 85mm
• 코핑 하부: 양쪽 각각 4단 헌치(대각/선반/대각/골) 구조, 기둥과 EL 2.825에서 만남, 중앙 골 부분은 EL 3.325로 평평
• 재료표(SD400) 철근 마크: C1C30(+변형 C30-1/C30-2), P1P10, S1S4, W1W2, 규격 H13/H16/H19/H22/H25/H29, 장이음 철근은 기계식 커플러 사용 (예: P1 마크 H29, L=71.055m, N=112)
• 1CYCLE 주철근(실제 배근도 좌표 기준): C1, C2, C3, C7, C8, C9, C10 (H25); 2CYCLE: C4, C5, C6, C11, C12, C13, C14 (H25) — 기존 P1 교각 프로젝트와 동일한 레이어/서브레이어/block 방식 사용

상시 규칙 (평강1교 전용)

• 단차/경사진 코핑 상단을 지나는 주철근은 단순 직선으로 배치한다 (단마다 따라가지 않음) — 기준면의 가장 낮은 지점에서 피복 120mm를 측정하고, 철근 전체를 그 한 높이에 평평하게 유지한다.
• 일반도와 구조도는 항상 함께 대조 확인한다 — 두 도면 사이에 코핑 하부 형상 관련 불일치가 발견된 적 있음(구조도는 단순 단일 대각 헌치, 일반도는 중앙 골 융기가 있는 프로파일).

rhino_mcp 사용 시 참고

• rhino_mcp 서버를 통해 현재 라이노에 열려 있는 씬(레이어, 오브젝트 등)을 직접 조회할 수 있다.
• 라이노를 새로 열었다면, 작업 전에 rhino_mcp_client.py(도구 → RhinoScript → 실행...)가 켜져 있는지 먼저 확인한다.