Local user guide
설치 없이 시작하는
음향 카메라 실험
Windows 10/11과 최신 Chrome 또는 Edge만 있으면 됩니다. 모든 입력과 계산은 이 컴퓨터의 브라우저 안에서 처리되며 외부 서버로 업로드되지 않습니다.
30초 확인
기본 결과 하나 저장하기
start.cmd를 더블클릭합니다.- 홈에서 Acoustic Camera를 엽니다.
- ▶ 기본 예제 실행을 누릅니다.
- 완료되면 Result JSON을 눌러 다운로드 폴더에 저장합니다.
5분 전체 흐름
내 장면을 만들고 Camera에서 실행하기
- Dataset Builder에서 이미지와 오디오를 선택하고 음원 위치, gain, 시간, ambient를 설정합니다.
- Scene JSON 저장을 누르고 사용한 원본 파일과 함께 보관합니다.
- Scene 저장 후 Camera 열기를 누릅니다.
- Camera에서 파일을 Scene → Array → Experiment → Assets 순서로 가져옵니다. 내 Array/Experiment가 없다면 내장 기본값을 그대로 둡니다.
- Assets에서 Builder에 사용한 원본 이미지와 오디오를 한 번에 다시 선택합니다. 준비 상태가 모두 초록색인지 확인합니다.
- Auto (GPU→CPU)로 실행한 뒤 Result JSON을 저장합니다.
Compute backend
속도와 격자 선택
| 선택 | 동작 | 권장 상황 |
|---|---|---|
| Auto (GPU→CPU) | WebGPU를 먼저 시도하고 불가능하면 CPU 사용 | 기본 권장 |
| WebGPU 강제 | GPU 장치가 없거나 실패하면 fallback 없이 오류 | GPU 비교·측정 |
| CPU 강제 | 동일한 자유음장 DAS를 CPU에서 계산 | 호환성 확인·기준 비교 |
먼저 50×50을 권장합니다. 100×100은 4배, 200×200은 16배의 scan point를 계산합니다. 실행 중에는 취소할 수 있으며, 취소하거나 실패해도 이전 완료 결과는 유지됩니다.
Result JSON
무엇이 저장되나요?
- rawMap / displayMap
- 선형 power 원본과 화면 표시용 acoustic map
- peaks
- 검출 위치, source 매칭, m·pixel 위치 오차
- metrics
- energy 비율, precision/recall, sidelobe, main-lobe 폭
- evaluation
- 검출 threshold, 반경, tolerance 등 지표 계산 조건
- timing / environment
- backend, grid·scan 범위, 장치 정보와 구간별 시간
- inputHash
- Array·Scene·Experiment 입력을 묶은 SHA-256 재현성 식별자
Troubleshooting
막혔을 때 확인할 것
화면이 비거나 module/Worker 오류가 납니다.
index.html을 직접 열지 말고 반드시 start.cmd로 실행하세요.
4173 포트를 사용할 수 없다고 나옵니다.
start.cmd -Port 4174처럼 다른 포트를 지정하고 http://127.0.0.1:4174/을 여세요.
Experiment를 가져올 수 없습니다.
Scene과 Array를 먼저 가져오세요. Experiment의 sceneId와 arrayId가 현재 문서와 같아야 합니다.
Assets가 준비되지 않습니다.
Builder에서 사용한 것과 바이트가 같은 원본 파일을 다시 선택하세요. 파일명뿐 아니라 SHA-256도 일치해야 합니다.
WebGPU가 없거나 실행이 너무 느립니다.
Backend를 Auto 또는 CPU로 두고 50×50 grid부터 실행하세요. 최신 Chrome/Edge와 그래픽 드라이버도 확인하세요.
Scope & privacy
현재 모델의 범위
micarrsim 1.0은 점 음원, 구면 감쇠·분수 지연을 쓰는 자유음장 모델과 conventional DAS를 제공합니다. 실내 반사·잔향, 실제 마이크 위치 오차와 비선형성, DAMAS, CLEAN-SC, DCASE/MIMII 자동 adapter는 현재 범위에 포함되지 않습니다. 결과는 실제 장비의 절대 성능 보증이 아니라 같은 조건에서 배열을 비교하는 재현 가능한 기준입니다.
원본 asset은 브라우저 메모리에서만 읽고 서버나 외부 네트워크로 보내지 않습니다. 다만 Scene JSON에는 원본 파일명이 남을 수 있으므로 외부 공유 전 확인하세요.