docs: add quick start and user guides
This commit is contained in:
@@ -1,3 +1,40 @@
|
||||
# Array Geometries
|
||||
|
||||
재현 가능한 마이크 배열 JSON 예제를 둡니다.
|
||||
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
|
||||
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`](../../schemas/array.schema.json) 구조를 따르고
|
||||
고유한 `id`, aperture와 microphone별 `[x, y, z]`를 가져야 합니다. 선택적인 `sensitivityDb`와
|
||||
`phaseOffsetDeg`는 합성 channel 편차와 beamforming 역 calibration에 사용됩니다.
|
||||
|
||||
@@ -1,3 +1,12 @@
|
||||
# Sample Scenes
|
||||
|
||||
재배포 가능한 최소 synthetic scene과 fixture를 둡니다.
|
||||
재배포 가능한 최소 synthetic fixture입니다. 외부 asset이 없어 서버를 시작한 직후 Camera에서
|
||||
바로 실행할 수 있습니다.
|
||||
|
||||
- `single-tone.scene.json`: 48 kHz, 0.25 s, 1 kHz tone 하나를 z=2 m 평면에 배치한 Scene
|
||||
- `single-tone.experiment.json`: rectangular 192채널 배열, 900–1100 Hz band, 50×50 scan,
|
||||
FFT 512 / hop 256, Auto backend를 쓰는 Experiment
|
||||
|
||||
두 문서는 계약 버전 `1.0.0`이며 기본 Camera 실행, CPU golden test, CPU/WebGPU 비교와 benchmark가
|
||||
같은 조건을 공유하도록 고정되어 있습니다. fixture를 바꿀 때는 <http://127.0.0.1:4173/tests/>의
|
||||
전체 테스트와 benchmark 입력 의미를 함께 확인하세요.
|
||||
|
||||
Reference in New Issue
Block a user