nbrightandClaude Opus 5 7a6b850ae6 Add unattended end-to-end run with restart-on-death
Built for running over a weekend with nobody at the keyboard.

run_all.sh chains every phase from bare machine to trained model and retries
each one with exponential backoff. Preflight is deliberately not retried: a
missing HF token or absent GPU will not fix itself, and burning the weekend on
a doomed retry loop is worse than failing in the first minute.

keepalive.sh sits above it and relaunches run_all if the process disappears
entirely (VM restart, OOM kill). Safe because every phase is idempotent -- a
restart re-checks what is already done and continues, and do_train hands the
newest checkpoint to the watchdog so training resumes instead of starting over.

voxel_max is measured rather than assumed: candidates are tried high to low and
the first that actually fits in VRAM wins. On WSL2 an oversized value does not
OOM, it silently spills to host RAM at 25-100x the cost, so peak allocation is
checked instead of trusting that the run worked.

RUN_ALL_DRYRUN runs preflight alone, to prove the checks pass before leaving.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-21 11:25:52 +09:00

sum-parts-test

드론 사진측량 메시를 건물 / 수목 / 차량 / 지면으로 분할하기 위한 SUM Parts (CVPR 2025) 재현 및 적용 작업.

대상 데이터: 서산 명천 도로 프로젝트 — ContextCapture OBJ 6블록, EPSG:5186.

이 레포에 있는 것

경로 내용
SETUP.md 새 머신에서 시작하는 절차 — 여기부터
docs/pipeline.html 6단계 공정 정의 (브라우저로 열 것)
docs/SUM-Parts-검토노트.md 트러블슈팅 16건, 데이터 스키마 실측, 라이선스
scripts/ 환경 구축 · 학습 · 평가 · 변환 스크립트 47개

데이터와 체크포인트는 커밋하지 않는다(.gitignore). 스크립트로 재생성한다.

요약

  • 모델: PointVector (논문 mIoU 70.0%, 번들 최고이자 최속)
  • 학습 자산: SUM Parts face 트랙 13클래스 → 우리 4클래스로 통합
  • 제약: 저자가 학습 가중치를 공개하지 않아 직접 학습이 유일한 경로
  • VRAM: 논문 설정 voxel_max 64000은 16.5GB 필요 → 12GB 카드 불가, 24GB 필요

빠른 시작

bash scripts/setup_env.sh
bash scripts/setup_pointnext.sh
bash scripts/patch_numpy_aliases.sh
bash scripts/patch_unlabeled_test.sh
bash scripts/patch_val_mode.sh
python scripts/verify_env.py          # ALL OK 확인

bash scripts/download_data.sh all     # HF 게이트 수동 수락 선행
bash scripts/prepare_full_split.sh
bash scripts/link_data.sh

bash scripts/launch_overnight.sh pointvector-xl

자세한 것은 SETUP.md.

라이선스

스크립트와 문서는 자유롭게 쓰되, 참조하는 SUM Parts는 데이터 CC BY-NC 4.0 / 코드 GPL-3.0이다. 상업 이용은 원저자 허락이 필요하다.

S
Description
SUM Parts (CVPR 2025) 재현 + 서산 명천 드론 메시 세그멘테이션 파이프라인. 건물/수목/차량/지면 4클래스 분할.
Readme
7.4 MiB
Languages
Shell 69.4%
Python 30.6%