@

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>
@

prompts/discovery_v1.txt

@@ -0,0 +1,84 @@
+# SAM 3.1 Segmentation Prompts - Color & Object Combinations
+
+# [General Categories]
+building
+building rooftop
+building facade
+residential house
+warehouse
+storage container
+factory structure
+asphalt road
+concrete pavement
+parking lot
+pedestrian sidewalk
+road lane marking
+crosswalk
+bare ground
+dirt field
+grass lawn
+tree canopy
+dense forest
+green hedge
+cast shadow
+
+# [Roofs & Structures by Color]
+blue roof
+red roof
+green roof
+gray roof
+dark gray roof
+black roof
+white roof
+silver metal roof
+orange roof
+brown roof
+yellow roof
+
+# [Vehicles & Transportation by Color]
+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
+
+# [Industrial Materials, Storage & Objects by Color]
+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
+plastic greenhouse
+vinyl greenhouse tunnel
+greenhouse roof
+gray metal fence
+green wire fence
+red roadside barrier
+yellow safety cone
+orange traffic cone
+
+# [Road Markings & Surface Features]
+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

prompts/wide_v1.txt

@@ -0,0 +1,12 @@
+# 타일보다 큰 대상 — 통짜(1×1)로 검출한다.
+# 여기 적힌 라벨은 타일 패스에서 제외된다.
+
+building
+asphalt road
+concrete pavement
+parking lot
+bare ground
+dirt field
+grass lawn
+tree canopy
+dense forest