docs: guide audio localization and live playback

docs/index.html

@@ -16,6 +16,7 @@
       <a class="guide-brand" href="/">← micarrsim 홈</a>
       <nav aria-label="문서 목차">
         <a href="#quick-start">빠른 시작</a>
+        <a href="#moving-live">이동 라이브</a>
         <a href="#full-workflow">내 데이터</a>
         <a href="#results">결과 해석</a>
         <a href="#troubleshooting">문제 해결</a>
@@ -52,16 +53,34 @@
         </div>
       </section>
 
-      <section class="guide-section" id="full-workflow">
+      <section class="guide-section" id="moving-live">
         <div class="section-number">02</div>
+        <div>
+          <p class="eyebrow">Moving-source demo</p>
+          <h2>이동 음원을 바로 재생하기</h2>
+          <ol class="guide-steps">
+            <li><a href="/apps/acoustic-camera/">Acoustic Camera</a>에서 <strong>이동 예제</strong>를 누릅니다.</li>
+            <li><strong>라이브 준비</strong>를 눌러 기본 2 Hz map을 계산합니다.</li>
+            <li><strong>재생</strong>을 누르거나 시간 slider를 움직입니다.</li>
+          </ol>
+          <aside class="callout">
+            짧은 시간창마다 계산한 heatmap과 trajectory 위치를 보간하는 합성 장면 미리보기입니다.
+            실제 192채널 마이크 스트림을 녹음하는 기능은 아닙니다.
+          </aside>
+        </div>
+      </section>
+
+      <section class="guide-section" id="full-workflow">
+        <div class="section-number">03</div>
         <div>
           <p class="eyebrow">5분 전체 흐름</p>
           <h2>내 장면을 만들고 Camera에서 실행하기</h2>
           <ol class="guide-steps">
             <li>
-              <a href="/apps/dataset-builder/">Dataset Builder</a>에서 이미지와 오디오를
-              선택하고 음원 위치, gain, 시간, ambient를 설정합니다.
+              <a href="/apps/dataset-builder/">Dataset Builder</a>에서 <strong>+ 오디오 파일 음원</strong>
+              또는 합성 음원을 추가하고 위치, gain, 시간과 ambient를 설정합니다.
             </li>
+            <li>움직이는 source는 <strong>시간에 따라 음원 이동</strong>을 켜고 keyframe을 편집합니다.</li>
             <li><strong>Scene JSON 저장</strong>을 누르고 사용한 원본 파일과 함께 보관합니다.</li>
             <li><strong>Scene 저장 후 Camera 열기</strong>를 누릅니다.</li>
             <li>
@@ -91,7 +110,7 @@
       </section>
 
       <section class="guide-section">
-        <div class="section-number">03</div>
+        <div class="section-number">04</div>
         <div>
           <p class="eyebrow">Compute backend</p>
           <h2>속도와 격자 선택</h2>
@@ -109,23 +128,33 @@
             먼저 50×50을 권장합니다. 100×100은 4배, 200×200은 16배의 scan point를 계산합니다.
             실행 중에는 취소할 수 있으며, 취소하거나 실패해도 이전 완료 결과는 유지됩니다.
           </p>
+          <p class="guide-copy">
+            복수 음원에서 약한 peak가 빠지면 <strong>Peak 검출 임계값</strong>을 기본 25%에서
+            10–20%로 낮춰 보세요. 약한 후보와 함께 sidelobe 오검출도 늘 수 있으며, main lobe보다
+            가까운 같은 대역 음원은 conventional DAS에서 하나로 합쳐질 수 있습니다.
+          </p>
         </div>
       </section>
 
       <section class="guide-section" id="results">
-        <div class="section-number">04</div>
+        <div class="section-number">05</div>
         <div>
           <p class="eyebrow">Result JSON</p>
           <h2>무엇이 저장되나요?</h2>
           <dl class="result-list">
             <div><dt>rawMap / displayMap</dt><dd>선형 power 원본과 화면 표시용 acoustic map</dd></div>
             <div><dt>peaks</dt><dd>검출 위치, source 매칭, m·pixel 위치 오차</dd></div>
+            <div><dt>beamSpread</dt><dd>half-power lobe의 power 가중 공분산과 1× RMS ellipse</dd></div>
             <div><dt>metrics</dt><dd>energy 비율, precision/recall, sidelobe, main-lobe 폭</dd></div>
             <div><dt>evaluation</dt><dd>검출 threshold, 반경, tolerance 등 지표 계산 조건</dd></div>
             <div><dt>timing / environment</dt><dd>backend, grid·scan 범위, 장치 정보와 구간별 시간</dd></div>
             <div><dt>inputHash</dt><dd>Array·Scene·Experiment 입력을 묶은 SHA-256 재현성 식별자</dd></div>
             <div><dt>comparison-history</dt><dd>세션의 배열별 시간·위치 오차·PSR 요약을 한 번에 저장</dd></div>
           </dl>
+          <aside class="callout">
+            화면의 <strong>빔 분포</strong> 1×/2× RMS contour는 acoustic power lobe의 모양입니다.
+            위치 확률, Gaussian 신뢰구간 또는 보정된 측정 불확실성이 아닙니다.
+          </aside>
           <aside class="callout">
             평가는 tone 음원을 해당 주파수 대역이 tone 주파수를 포함할 때만 정답으로 사용합니다.
             noise와 asset 음원은 현재 모든 대역의 정답으로 간주합니다. 녹음 파일의 실제 대역별
@@ -140,7 +169,7 @@
       </section>
 
       <section class="guide-section" id="troubleshooting">
-        <div class="section-number">05</div>
+        <div class="section-number">06</div>
         <div>
           <p class="eyebrow">Troubleshooting</p>
           <h2>막혔을 때 확인할 것</h2>
@@ -164,18 +193,26 @@
             <summary>WebGPU가 없거나 실행이 너무 느립니다.</summary>
             <p>Backend를 Auto 또는 CPU로 두고 50×50 grid부터 실행하세요. 최신 Chrome/Edge와 그래픽 드라이버도 확인하세요.</p>
           </details>
+          <details>
+            <summary>두 번째 음원을 찾지 못합니다.</summary>
+            <p>두 음원이 같은 주파수 대역인지 확인하고 Peak 검출 임계값을 낮추세요. gain 차이, main-lobe 폭보다 짧은 거리, grid 간격과 sidelobe는 threshold만으로 해결되지 않을 수 있습니다.</p>
+          </details>
+          <details>
+            <summary>라이브 준비 버튼이 비활성화됩니다.</summary>
+            <p>Scene에 시간 순서가 올바른 trajectory keyframe이 두 개 이상 있어야 합니다. Builder에서 시간에 따라 음원 이동을 켜거나 Camera의 이동 예제를 사용하세요.</p>
+          </details>
         </div>
       </section>
 
       <section class="guide-section">
-        <div class="section-number">06</div>
+        <div class="section-number">07</div>
         <div>
           <p class="eyebrow">Scope & privacy</p>
           <h2>현재 모델의 범위</h2>
           <p class="guide-copy">
             micarrsim 1.0은 점 음원, 구면 감쇠·분수 지연을 쓰는 자유음장 모델과 conventional
             DAS를 제공합니다. 실내 반사·잔향, 실제 마이크 위치 오차와 비선형성, DAMAS,
-            CLEAN-SC, DCASE/MIMII 자동 adapter는 현재 범위에 포함되지 않습니다. 결과는 실제
+            CLEAN-SC, DCASE/MIMII 자동 adapter와 실제 192채널 capture stream은 현재 범위에 포함되지 않습니다. 결과는 실제
             장비의 절대 성능 보증이 아니라 같은 조건에서 배열을 비교하는 재현 가능한 기준입니다.
           </p>
           <p class="guide-copy">