Files
micarrsim/schemas/README.md
T

1.3 KiB

Schemas

마이크 배열, scene, experiment, result의 versioned JSON Schema를 둡니다.

JSON Schema Draft 2020-12 형식입니다.

  • array.schema.json: 배열 크기, 좌표계, 마이크 위치와 선택적 scalar/주파수 응답 보정값
  • scene.schema.json: 음원 recipe, asset·trajectory와 선택적 sparse shoebox 음향 환경
  • experiment.schema.json: scan plane/grid, 주파수 대역, STFT/DAS와 peak 검출 임계값
  • result.schema.json: raw/display/후처리 map, 복수 peak, 비확률 beam spread, timing과 평가 지표

마이크 주파수 응답점은 배열 계약 자체이므로 특정 Scene의 Nyquist와 결합하지 않고 0~1 MHz의 안전 범위에서 엄격한 오름차순을 요구합니다. 실제 분석에서는 선택한 Scene/STFT의 bin 주파수만 보간합니다. 중복 id, Nyquist, 시간 구간과 참조 무결성은 packages/contracts/validation.js에서 추가로 검증합니다.

Scene acoustics는 기본 free-field 또는 shoebox입니다. shoebox는 room bounds, 0/1차 반사와 scattering 비율, bounded diffuse tail, 최대 8개의 AABB occluder를 저장합니다. room·occluder의 각 축은 min < max여야 하고 source/trajectory와 occluder는 room 안에 있어야 합니다. 이 계약은 전체 파동 해석이 아니라 sparse path 근사의 입력입니다.