docs: V3 CenterAligner 2-Pass 이식 반영

- docs/ALGORITHM_COMPARISON.md
  * "V3: CenterAligner 2-Pass BVCV" 신규 서브섹션
  * Python 원본 매핑 · 검증 방식 · commit ID 명시
  * V1 3-stage / V2 6-stage / V3 2-Pass 세 알고리즘 병행 정리
- VesiScan_Android_Pipeline_Summary.md
  * v7 patch 헤더 2026-07-13 → 2026-07-15
  * Alignment 섹션 V3 항목 신규 (piezophantomtest PR #35 링크,
    Pass 1/2 요약, 검증 결과 요약, UI 후속 작업 표기)

기능 변화 없음. V3 라이브러리 이식 (커밋 9387552 / fcdce12) 을 문서에 반영.
This commit is contained in:
2026-07-15 16:04:42 +09:00
parent fcdce12503
commit 909eac9ca3
2 changed files with 61 additions and 3 deletions
+14 -2
View File
@@ -2,7 +2,7 @@
## 작성일: 2026-04-23
## 작성자: dwjang
## 마지막 업데이트: 2026-07-13 (v7 patch) — 1.2.0-demo (versionCode 26)
## 마지막 업데이트: 2026-07-15 (v7 patch) — 1.2.0-demo (versionCode 26)
## 권장 펌웨어: **VBTFW0120+** (mim FIFO 지원 필수. VBTFW0121 은 `mls mode 0` handler 취약)
### v7 주요 변경 요약 (2026-07-06 ~ 2026-07-10)
@@ -27,7 +27,19 @@
- **lastBleRxAt 갱신 확대** (커밋 3a41864). `processReceivedData` 진입점에서
모든 유효 응답에 대해 갱신 → "기기 응답 없음" false-positive 배너 해소.
**Alignment (V2 6-stage)**
**Alignment (V2 6-stage + V3 2-Pass)**
- **V3 CenterAligner 2-Pass BVCV 이식** (커밋 9387552 / fcdce12, 2026-07-15).
piezophantomtest PR #35 (`ffd436b`) 의 `vesiscan_test.alignment.CenterAligner`
를 Kotlin 으로 1:1 이식. Clinical 세션 전용 batch 방식 (실시간 V2 와 병행).
- Pass 1 `scanSelect`: 0~4 cm 각 20 cycle → 11 trace → Rule A + bvcv tie 선택
(ch3 필수 + per-trace ch3 검출률 ≥ 80% + max nch + min bv_cv)
- Pass 2 `guide`: 재측정 위치가 target 기준 (ch3, 검출률, nch, bv_cv × 1.15)
충족 시 STOP, 미충족 시 MOVE_UP
- MethodDRunner (apply_cross false/true 두 모드) + PiezoBVEstimator 재사용
- **검증**: `CenterAlignerValidationTest` — data123 인체 3 세션 대상
Python reference 와 nch/ch3/ch3_hit 완전 일치, bv_cv 오차 <2%,
최종 선택 = cm=3 일치. 상세: [docs/ALGORITHM_COMPARISON.md](docs/ALGORITHM_COMPARISON.md#v3-centeraligner-2-pass-bvcv-alignmentadvisorv3kt-2026-07-15).
- UI 통합 (Pass 1/2 화면) 은 후속 작업.
- **CH3 flicker 무한 대기 방지** (커밋 e808b5b). VERTICAL_CLIMB 진입 조건을
"3연속 hit" → "최근 6프레임 중 3회 hit" sliding window majority 로 완화.
20 프레임 대기 시 상단 3채널 relaxed mode 진입 (CH3 없이도 정렬 완료).