micarrsim/assets/array-geometries/README.md

Array Geometries

Camera에서 즉시 사용하고 테스트에서 재현할 수 있는 계약 버전 1.0.0의 192채널 Array JSON fixture입니다. 좌표 단위는 m이고 모든 microphone은 배열 평면 z = 0에 있습니다. +x는 오른쪽, +y는 위, +z는 scene 방향입니다.

포함된 배열

rectangular-16x12.array.json

• 16 columns × 12 rows = 192 microphones
• 폭과 높이가 각각 0.45 m인 정사각 aperture
• x/y 양 끝을 포함해 균일한 간격으로 배치
• 기본 single-tone experiment와 CPU/WebGPU 기준 fixture가 참조하는 baseline

fermat-spiral-192.array.json

• 192 microphones
• 반지름 0.225 m, 지름 0.45 m인 원형 aperture
• golden angle과 면적 균등 반지름으로 만든 Fermat spiral
• rectangular baseline과 sidelobe·집중도·위치 오차를 비교하기 위한 preset

Acoustic Camera의 비교 배열에서 두 배열을 선택해 같은 Scene/Experiment 결과를 세션 기록에 나란히 추가할 수 있습니다.

fixture 다시 생성하기

저장소 최상위에서 다음 명령을 실행하면 두 JSON을 결정론적으로 다시 생성합니다.

powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\scripts\generate-array-fixture.ps1

이 스크립트는 기존 rectangular-16x12.array.json과 fermat-spiral-192.array.json을 덮어씁니다. ExecutionPolicy Bypass는 이 PowerShell 프로세스에만 적용됩니다. 생성 뒤 http://127.0.0.1:4173/tests/에서 schema와 192채널 배치 검증을 실행하세요.

사용자 배열은 ../../schemas/array.schema.json 구조를 따르고 고유한 id, aperture와 microphone별 [x, y, z]를 가져야 합니다. 선택적인 sensitivityDb와 phaseOffsetDeg는 합성 channel 편차와 beamforming 역 calibration에 사용됩니다.