@

docs: 집합 조정(M2) 보류 기록 + 반입 목록 실측

M2 는 교통시설물을 가르는 안까지 만들고 보류했다. 16장 실측으로
structure 1,079 -> utility pole 608 / streetlight pole 372 /
road sign 358 / culvert 9, fence 702 -> guardrail 668 / fence 46 /
roadside barrier 17 로 갈라지는 것을 확인했다 (라벨 14 -> 19종).
사용자 지시로 v4 로 되돌렸고 v5 는 보류 표시와 함께 남긴다.
culvert 9개, roadside barrier 17개는 16장 기준 표본이 부족하다.

정정: "집합 없는 검출은 버려진다"는 앞선 판단은 틀렸다.
merge_labels.py 의 merge_by_group 은 집합에 없는 라벨을 passthrough 로
그대로 통과시킨다. 16장 병합 결과에 orange traffic cone 114 개와
yellow safety cone 6 개가 독립 클래스로 살아 있다. [cone] 으로 묶으면
오히려 나란히 선 콘이 gap 2px 에서 한 덩어리가 되어 개수를 잃는다.

envsetting.md 에 반입 목록을 실측 크기로 정리했다:
  git 으로 오는 것 (복사 금지)
  손으로 복사할 것  체크포인트 3.3GB / BPE 1.4MB / JPEG 69장 1.2GB
  복사하면 안 되는 것  venv(절대경로), output/, theater 뷰어 JPEG 55MB

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

configs/merge_groups_v5.txt

@@ -0,0 +1,180 @@
+# ==========================================================
+# 보류 (2026-09-02). 세부 세그멘테이션은 후순위로 미뤘다.
+# 현재 쓰는 정의는 configs/merge_groups_v4.txt 다.
+#
+# 이 파일은 교통시설물을 뭉치지 않고 가른 안이다. 16장 실측으로
+# structure 1,079 -> utility pole 608 / streetlight pole 372 /
+# road sign 358 / culvert 9, fence 702 -> guardrail 668 /
+# fence 46 / roadside barrier 17 로 갈라지는 것까지 확인했다.
+# 라벨 14종 -> 19종, 폴리곤 6,370 -> 6,667.
+#
+# 다시 쓸 때 주의: culvert 9개, roadside barrier 17개는 16장 기준
+# 표본이 너무 적다. 69장 전체를 돌린 뒤 클래스로 쓸지 판단해라.
+# ==========================================================
+
+# 병합 그룹 정의 — 대괄호 안이 병합 후 대표 라벨.
+# 같은 그룹에 속한 라벨끼리 외곽선이 --gap px 이내로 인접하면 하나로 합친다.
+# 어느 그룹에도 없는 라벨은 건드리지 않는다.
+#
+# 여기서 나누지 않는 구분이 있다. SAM은 사진만 보므로 미터도 규모도 모른다.
+# 아래는 2D가 아니라 3D 메시에서 갈라야 정확하다:
+#   낮은수목 / 수목      CSF 지면 위 높이
+#   수목 / 숲            [vegetation] 연결성분 면적
+#   지형 / 경사면        면 법선 경사각
+#   건물 / 빌딩          [building] 연결성분 면적·높이
+# 그래서 tree canopy와 dense forest, building과 residential house는
+# 일부러 같은 그룹에 둔다 — 2D에서 갈라봐야 중복 마스크만 나온다.
+
+# [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]
+gravel shoulder
+asphalt road
+concrete pavement
+parking lot
+pedestrian sidewalk
+crosswalk
+bridge
+
+# 아래는 비활성 — discovery_v1.txt에서 프롬프트를 통째로 껐다.
+# 최종 목표가 지면 대 나머지라 차선은 도로면의 일부지 별도 클래스가 아니다.
+# 검출량 1위였지만(583개 중 277개) 전부 [road] 안에서 버려지고,
+# 논밭 이랑을 yellow center dividing line으로 오인하기까지 했다.
+# [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]
+yellow grass field
+overgrown weeds
+shrub
+tree canopy
+dense forest
+green hedge
+grass lawn
+
+# [farmland]
+ripening rice field
+harvested field
+crop field
+farmland
+plowed field
+bare soil field
+rice paddy
+vegetable field
+
+# [ground]
+bare ground
+dirt field
+earth bank
+dirt path
+
+# [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
+
+# [retaining wall]
+retaining wall
+concrete retaining wall
+gabion wall
+
+# [slope]
+grass covered embankment
+road embankment slope
+cut slope
+riprap slope
+
+# [water]
+water surface
+pond
+reservoir
+stream
+irrigation canal
+drainage ditch
+
+# 교통시설물은 나중에 더 자세히 봐야 하므로 하나로 뭉치지 않는다.
+# 전주/가로등/표지판은 형태도 역할도 다르다 — [structure] 로 묶으면
+# 병합 후에 다시 못 가른다. 같은 물건의 다른 이름만 한 집합에 둔다.
+
+# [utility pole]
+utility pole
+
+# [streetlight pole]
+streetlight pole
+
+# [road sign]
+road sign
+
+# [structure]
+culvert
+
+# [fence]
+gray metal fence
+green wire fence
+
+# [guardrail]
+guardrail
+metal guardrail
+
+# [roadside barrier]
+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
+
+# 콘은 일부러 어느 집합에도 넣지 않는다.
+# merge_labels.py 는 집합에 없는 라벨을 건드리지 않고 그대로 통과시킨다
+# (merge_by_group 의 passthrough). 그래서 콘은 버려지지 않고 독립 클래스로 남는다.
+# [cone] 으로 묶으면 나란히 선 콘이 gap 2px 에서 한 덩어리가 되어 개수를 잃는다.
+# 16장 실측: orange traffic cone 114 · yellow safety cone 6 이 그대로 살아 있다.