이 폴더는 검증 과정에서 나온 원자료와 작업 문서다. 결론은 저장소 루트의
README.md에 있고, 여기에는 그 결론을 뒷받침하는 것들이 있다.
2026-08-19에 재편했고, 2026-08-29에 재현 가능한 잔여 결함을 후보 패치로 닫은 뒤 현재 판정과 역사 기록을 다시 분리했다.
| 폴더 | 내용 |
|---|---|
upstream/ |
상류 보고 원본·붙여넣기본. bridge lifecycle은 2026-08-31 issue #951과 signed PR #952로 제출됐고, 나머지는 미제출이다 |
wiki/ |
DAVE Notion Wiki 정정 이력과 범위 |
results/ |
날짜별 실험 결과와 기계 판독 가능한 요약 |
experiments/ |
실험 스크립트와 공통 측정 절차 |
benchmarks/ |
초기 벤치마크와 superseded 결과 |
stability/ |
장시간 시험; 폴더명 경고를 먼저 읽어야 한다 |
setup/ |
환경 구축 기록 |
evidence/ |
개별 주장 근거 |
meeting/ |
랩 미팅 자료 |
results/remaining_defect_fixes_2026-08-29/은
기존 감사에서 남은 재현 가능한 결함을 수정한 최초 8개 후보 패치의 Mac/Docker 결과다.
최종 open-gap sweep에서 fifth-ROV sonar world 누락을 닫은 9번째 후보는
results/open_gap_revalidation_2026-08-29/에 있다.
공식 ArduPilot Gazebo plugin·ArduSub·MAVROS·QGroundControl 통합을 닫은 10번째 후보와 Docker
recipe 근거는 results/external_stack_validation_2026-08-29/에 있다.
2026-08-30의 DVL LLDB, RViz, Fast DDS, camera startup, 결합 sonar/control,
fresh Docker build와 rendered RDP/QGC 근거는
results/final_gap_validation_2026-08-30/에 있다.
같은 날 exact Gazebo tag에서 만든 Mac DVL initialization 후보의 baseline·rejected 9/10 후보·20/20 최종 후보·ROS bridge·회귀 근거는
results/dvl_macos_force_update_candidate_2026-08-30/에 있다.
Docker software-WGPU/OGRE2 sonar crash의 최소 재현, 폐기 후보, WGPU 2회·auto·CPU 회귀와
Heavy+ArduSub/MAVROS 결합 통과 근거는
results/multibeam_llvmpipe_deferred_backend_candidate_2026-08-30/에 있다.
그 후보의 20회 cold start, Heavy 3회 반복, process-group 종료 10회와 bounded 30분 soak는
results/multibeam_deferred_backend_extended_validation_2026-08-30/에 있다.
CPU·배포 WGPU·정확히 relink한 exact-N 후보의 6개 장면 수치 대조는
results/multibeam_backend_equivalence_matrix_2026-08-30/,
integrated ocean-waves world의 직접 payload·stats·resource snapshot은
results/integrated_sonar_payload_validation_2026-08-30/,
세 BlueROV image/source sensor contract 분리는
results/bluerov_sensor_contract_validation_2026-08-30/에 있다.
2026-08-31에는 Fast DDS 160-create stress, focused bridge teardown와 ownership-cycle 후보,
sensor long/multi, camera six-tag, USBL namespace, sonar determinism/cache,
clean ocean-sonar/manipulation replay, Ocean Current noise/tide controls를 추가했다. Bridge 후보는
results/parameter_bridge_cycle_fix_validation_2026-08-31/에 있고,
나머지 근거는 같은 날짜의 results/*_2026-08-31/ 폴더에 있다. 특히 tide는 global topic이 아니라
documented per-model output으로 판정한다. DAVE와 Gazebo 후보는 여전히 격리본이며 해당
설치 workspace를 바꾸지 않았다. 예외는 ros_gz_bridge ownership 후보로, 이후 실제 사용자
ros_gz workspace에 적용·빌드하고 signed upstream PR #952까지 열었다.
검증된 후보 패치 범위:
- Multibeam WGPU의 한 평면 장면 gross range shift, 4096-bin GPU 경계와 명시적 CUDA 실패 경로
- Underwater Camera R/B 의미론
- SeaPressure ROS 계약과 여섯 설정 제어
- Spherical 입력 검증·실패 상태·paused/no-config·plugin discovery
- DVL 8/8 descriptor 초기화, frame ID, water-mass 변수
- USBL
sigma=0, paused callback, 이동 표적, fractional delay - object missing-descriptor preflight, launch headless/debug/non-TTY, 18/18 world 이름
- Ocean/Spherical/sonar package plugin-discovery hooks와 Release build 안내
dave_ocean_waves의 fifth-ROV sonar용MultibeamSonarSystemworld 누락- 세 BlueROV variant ArduSub의 명시적 speedup, 공식 Gazebo plugin, MAVROS 통합 제어와 baseline QGroundControl 경로
ros_gz_bridgehandle→owner strong-reference cycle와 DAVE-sonar shutdown-only exit -11- 현재 Dockerfile의 fresh
--no-cache빌드(66.917분, 6,260,137,751 bytes), pin/package 검사, real RDP/XFCE framebuffer와 Gazebo+QGC connected replay; 이전 cache image의 세 variant full control
여전히 열린 범위는 Docker hardware WGPU/NVIDIA CUDA, macOS RViz의 영구 창 수정,
QGroundControl 기본 AppRun의 GLib 충돌(검증 recipe는 opt-out 적용), sonar 30 Hz·ROV/Glider
calibration 결정, Fuel immutable pin/upload, Windows/WSL·실물 gamepad/HIL과 일반
음향·광학·유체역학·장시간 정확도다. Mac stock DVL crash는 exact-tag 후보에서 hidden camera 없이
20/20 복구됐고 ROS four-beam bridge와 camera/no-render 회귀도 통과했다. 다만 후보는 격리 빌드일 뿐
Homebrew/상류 Gazebo에 적용되지 않아 배포 경로는 여전히 PARTIAL이다. Heavy-multibeam의
distributed software-WGPU/llvmpipe 경로는 exit 139를 재현하지만, 격리 startup-order 후보는
fresh WGPU cold start 20/20, Heavy arm/control/disarm 3/3과 bounded 1,861초 soak를 통과했다.
teardown baseline은 no-publisher 40/40·stock active 30/30 clean이지만 DAVE-sonar active one-way
9/10과 PointCloud-only 2/10이 SIGSEGV였다. Exact-ros_gz 3.0.9 ownership-cycle 후보는
bridge-first 20/20 clean, process-group 10/10 rc0, direct ROS→GZ 20/20과 stock active
camera/PointCloud 5/5 each를 통과했다. 제한된 upstream package suite는 17/18 CTest target이
통과했고, 유일한 remote-schema xmllint timeout도 canonical schema를 로컬로 공급한 exact XML
검사에서 통과했다. 따라서 로컬 재현 결함은 후보에서 닫혔다. 이어 normal isolated install에서 8/8 topic, 1/1 ControlWorld service, active teardown 10/10을 통과했고 official-image ARM64 Humble/Jazzy/Kilted branch-local overlay도 각각 8/8+1/1과 clean bridge exit를 통과했다. Apple-Silicon 위 Jazzy linux/amd64 Docker 에뮬레이션도 같은 8/8+1/1을 통과했다. ordinary-layout 격리 복제본은 24/24 방향(고유 topic type pair 13개)과 exact-3.0.9 service factory 4/4를 통과했다. 이후 실제 사용자 ros_gz workspace에도 후보를 적용해 기존 CMake 편집 2건을 보존한 채 빌드했고, 모든 generated topic mapping 73쌍을 양방향으로 생성해 payload 73/73 each, ordered bridge rc0, 반복 payload 5/5와 lifecycle 11/11을 통과했다. 다만 ordered component는 topic 3/3·service 1/1 assertion 뒤 bridge_node가 SIGINT에서 139로 종료돼 별도 macOS teardown 결함으로 남는다. issue #951과 signed PR #952이 열려 있다. upstream maintainer merge, native x86_64 hardware, Windows와 hardware GPU는 외부 범위다. Fast DDS create
hang은 2026-08-31 dirty/20-SIGKILL/clean/UDP stress 160/160에서도 재현되지 않았고, exact camera Quickstart는
120초 창에서 default 3/3·UDP 3/3 통과해 이전 짧은 대기 실패를 startup latency로 정정했다.
이전 exact cache image는 Windows App RDP login/rendering과 QGC vehicle connection을 통과했다.
current recipe도 fresh --no-cache로 66.917분에 완주했고, 별도 FreeRDP/xrdp 세션에서 Xorg/XFCE framebuffer와 Gazebo+QGC connected 화면을 다시 통과했다. 두 클라이언트 실행을 같은 것으로 섞지 않는다.
이전 날짜의 직접 검증 폴더는 삭제하지 않는다. 2026-08-29 패치가 무엇을 바꿨는지 확인하려면 이전 실패 근거와 현재 결과를 함께 읽어야 한다.
루트 README.md 는 입구 역할만 한다. 상류 저장소(IOES-Lab/dave,
dockwater)의 README 도 그렇게 쓰므로 형식을 맞췄다. 실제 내용은 아래에 있다.
| 파일 | 내용 |
|---|---|
what-we-got-wrong.md |
틀렸던 주장과 그걸 잡아낸 경위. 여기 수치를 믿기 전에 읽을 것 |
validation_matrix.csv |
검증 항목 전체 표. 무엇이 PASS 이고 무엇이 안 해본 것인지의 기준 |
verified-demos.md |
각 판정이 무엇에 근거하는지 |
known-issues.md |
49개 항목(열림·후보 패치 해결·철회 이력 포함), 현재 처리는 문서 맨 위 표 참고 |
progress-log.md |
날짜별 작업 112행. 무엇이 나중에 뒤집혔는지가 Notes 열에 있다 |
sonar-performance.md |
소나 측정값과 이전 수치를 대체한 경위 |
patch-and-pinned-commits.md |
고정 커밋과 이식 패치의 현재 상태 |
next-steps.md |
아직 열려 있는 항목 |
status-history.md |
옛 상태 요약. 어떤 주장이 언제 철회됐는지 추적용 |
cmake-migration-patterns.md |
Harmonic→Jetty 이식에서 반복된 패턴 |
usbl-gui-crash-investigation.md |
USBL 크래시 추적. 초기 가설(GUI 문제)이 틀렸던 과정이 남아 있다 |
처음이면 루트 README.md → validation_matrix.csv →
progress-log.md → 관심 있는 항목의 results/ 하위 폴더.
상류 보고를 맡았다면 upstream/submit/README.md 하나만 보면 된다.
SUPERSEDED_*, CONTAMINATED, PRE_LEAKFIX_SCRIPT 가 붙은 것들은 틀린 결과이지만
남겨둔다. 어떤 수치가 언제 왜 바뀌었는지 추적할 수 있어야 하고, 지우면 그 이력이
사라진다. 인용할 때는 이름에 붙은 표시를 먼저 볼 것.