docs: explain full-band activity workflow

This commit is contained in:
2026-08-29 14:03:38 +09:00
parent 51e346a477
commit 764cf28cf8
9 changed files with 252 additions and 19 deletions
+30 -7
View File
@@ -17,6 +17,7 @@
<nav aria-label="문서 목차">
<a href="#quick-start">빠른 시작</a>
<a href="#moving-live">이동 라이브</a>
<a href="#activity">전 대역 검사</a>
<a href="#array-builder">배열 만들기</a>
<a href="#full-workflow">내 데이터</a>
<a href="#acoustic-model">환경·실측</a>
@@ -71,8 +72,29 @@
</div>
</section>
<section class="guide-section" id="array-builder">
<section class="guide-section" id="activity">
<div class="section-number">03</div>
<div>
<p class="eyebrow">Unknown-frequency activity</p>
<h2>분석 주파수를 모를 때</h2>
<ol class="guide-steps">
<li><a href="/apps/acoustic-camera/">Acoustic Camera</a>의 분석 대역 아래 <strong>전 대역 활동 검사</strong>를 펼칩니다.</li>
<li>한 물리 마이크와 OS-CFAR·CA-CFAR 또는 Dixon spectral flux를 고르고 <strong>전 대역 검사</strong>를 누릅니다.</li>
<li>CFAR candidate의 ADC bin과 raw CUT/reference/threshold를 확인합니다. Spectral flux는 onset novelty만 봅니다.</li>
<li>아날로그 center 가설을 직접 입력해 별도 band로 추가한 뒤 Snapshot 위치추정을 실행합니다.</li>
<li>모든 complete frame/bin은 <strong>Activity JSON</strong>으로 저장합니다.</li>
</ol>
<aside class="callout callout--important">
Nyquist 초과 가설도 허용하지만 Scene truth로 원 주파수를 고르지 않습니다.
CFAR Pfa는 tested CUT 하나당 명목값이고 spectral flux는 확률이 아닙니다.
검출기·band·위치 map의 자동 fusion도 하지 않습니다.
<a href="/docs/activity-detection.md">수식과 물리적 한계</a>를 함께 확인하세요.
</aside>
</div>
</section>
<section class="guide-section" id="array-builder">
<div class="section-number">04</div>
<div>
<p class="eyebrow">Microphone geometry</p>
<h2>내 마이크 배열 만들기</h2>
@@ -95,7 +117,7 @@
</section>
<section class="guide-section" id="full-workflow">
<div class="section-number">04</div>
<div class="section-number">05</div>
<div>
<p class="eyebrow">5분 전체 흐름</p>
<h2>내 장면을 만들고 Camera에서 실행하기</h2>
@@ -145,7 +167,7 @@
</section>
<section class="guide-section">
<div class="section-number">05</div>
<div class="section-number">06</div>
<div>
<p class="eyebrow">Localization &amp; compute</p>
<h2>알고리즘, 속도와 격자 선택</h2>
@@ -194,7 +216,7 @@
</section>
<section class="guide-section" id="acoustic-model">
<div class="section-number">06</div>
<div class="section-number">07</div>
<div>
<p class="eyebrow">Acoustics & measured input</p>
<h2>환경과 마이크 응답 선택</h2>
@@ -216,7 +238,7 @@
</section>
<section class="guide-section" id="results">
<div class="section-number">07</div>
<div class="section-number">08</div>
<div>
<p class="eyebrow">Result JSON</p>
<h2>무엇이 저장되나요?</h2>
@@ -256,7 +278,7 @@
</section>
<section class="guide-section" id="troubleshooting">
<div class="section-number">08</div>
<div class="section-number">09</div>
<div>
<p class="eyebrow">Troubleshooting</p>
<h2>막혔을 때 확인할 것</h2>
@@ -296,7 +318,7 @@
</section>
<section class="guide-section">
<div class="section-number">09</div>
<div class="section-number">10</div>
<div>
<p class="eyebrow">Scope & privacy</p>
<h2>현재 모델의 범위</h2>
@@ -320,6 +342,7 @@
<a href="/apps/array-builder/README.md"><strong>Array Builder 설명서</strong><span>마이크 배치·프리셋·JSON</span></a>
<a href="/apps/dataset-builder/README.md"><strong>Dataset Builder 설명서</strong><span>source·ambient·Preview WAV</span></a>
<a href="/apps/acoustic-camera/README.md"><strong>Camera 설명서</strong><span>backend·결과·비교</span></a>
<a href="/docs/activity-detection.md"><strong>전 대역 활동 검출</strong><span>CFAR·spectral flux·alias 가설</span></a>
<a href="/docs/acoustic-model.md"><strong>음향 모델</strong><span>마이크 응답·반사·산란·회절</span></a>
<a href="/docs/realtime-porting.md"><strong>실측 포팅</strong><span>block·streaming 위치추정 API</span></a>
<a href="/docs/data-contracts.md"><strong>데이터 계약</strong><span>JSON Schema와 재현성</span></a>