@

feat: SAM3.1 다중 프롬프트 배치 검출 및 라벨 병합 후처리

sam3_multi_prompt.py: 프롬프트 N개를 forward 1회에 배치 처리한다.
서버(프롬프트당 forward 1회) 대비 forward 횟수가 1/N로 줄고, 이미지
임베딩과 텍스트 인코딩을 타일 전체에서 재사용한다. RTX 3060 12GB
기준 배치 16이 최적(32 이상은 VRAM 압박으로 4배 이상 느려짐).

타일보다 큰 대상(숲, 도로, 주차장)은 타일 경계에서 잘려 사각형
마스크가 되므로 --wide-prompts 로 지정해 이미지 전체를 한 장으로
처리한다.

merge_labels.py: 검출 결과 후처리. 같은 병합 그룹에 속한 라벨끼리
외곽선이 gap px 이내로 인접하면 하나로 합치고 대표 라벨을 붙인다
(building + building rooftop + blue roof -> building). 병합 전
claim 규칙으로 소유권을 재배정해, 차량 위에 잡힌 *roof 폴리곤이
건물이 아니라 차량에 합쳐지도록 한다.

make_viewer.py: 라벨별 on/off 가능한 단독 HTML 뷰어 생성.
프롬프트 파일의 그룹 주석 기준으로 라벨을 묶어 나열하고, 줌/팬과
선택 상태 저장을 지원한다.

cut_tiles.py: R{행}C{열} 격자 오버레이 + 원본 배율 타일 저장.

전역 규칙 반영:
- CUDA 사용 불가 시 CPU로 폴백하지 않고 즉시 에러
- set_per_process_memory_fraction 으로 드라이버의 시스템 메모리
  폴백(10배 이상 느려짐) 전에 OOM 발생
- 체크포인트/BPE 경로 하드코딩 제거. CLI 인자 -> 환경변수 ->
  sam31server 설정파일 순으로 해결

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@

configs/claim_rules.txt

@@ -0,0 +1,7 @@
+# 소유권 재배정 규칙 — 병합 전에 실행된다.
+# 형식:  <가져갈 그룹> : <최소 겹침 비율> : <대상 라벨, 콤마 구분>
+#
+# 대상 라벨의 폴리곤이 그 그룹 폴리곤과 자기 면적의 <비율> 이상 겹치면,
+# 겹친 상대의 라벨로 바꿔 붙인다. (예: 자동차 위의 "white roof" → "white vehicle")
+
+vehicle : 0.5 : blue roof, red roof, green roof, gray roof, dark gray roof, black roof, white roof, silver metal roof, orange roof, brown roof, yellow roof, blue waterproof tarp, black protective sheet

configs/merge_groups.txt

@@ -0,0 +1,94 @@
+# 병합 그룹 정의 — 대괄호 안이 병합 후 대표 라벨.
+# 같은 그룹에 속한 라벨끼리 외곽선이 --gap px 이내로 인접하면 하나로 합친다.
+# 어느 그룹에도 없는 라벨은 건드리지 않는다.
+
+# [building]
+building
+building rooftop
+building facade
+residential house
+warehouse
+factory structure
+storage container
+blue roof
+red roof
+green roof
+gray roof
+dark gray roof
+black roof
+white roof
+silver metal roof
+orange roof
+brown roof
+yellow roof
+greenhouse roof
+plastic greenhouse
+vinyl greenhouse tunnel
+
+# [road]
+asphalt road
+concrete pavement
+parking lot
+pedestrian sidewalk
+crosswalk
+
+# [road marking]
+road lane marking
+yellow center dividing line
+white solid lane marking
+white dashed lane marking
+white directional arrow marking
+yellow parking stall line
+white parking stall line
+blue handicap parking space
+pink pedestrian safety marking
+green bike lane marking
+
+# [vegetation]
+tree canopy
+dense forest
+green hedge
+grass lawn
+
+# [ground]
+bare ground
+dirt field
+
+# [stored material]
+blue plastic drum
+orange plastic barrel
+yellow plastic container
+white industrial tank
+metallic storage tank
+blue waterproof tarp
+green waterproof tarp
+black protective sheet
+white canvas canopy
+
+# [fence]
+gray metal fence
+green wire fence
+red roadside barrier
+
+# [vehicle]
+white vehicle
+black vehicle
+silver vehicle
+gray vehicle
+red vehicle
+blue vehicle
+yellow vehicle
+orange vehicle
+green vehicle
+white cargo truck
+blue cargo truck
+yellow school bus
+commercial bus
+tractor
+farm tractor
+excavator
+
+# 아래는 기본 비활성 — 나란히 놓인 콘이 한 덩어리로 융합된다.
+# [cone]
+# yellow safety cone
+# orange traffic cone