Files

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 tone·Experiment band는 특정 Scene의 Nyquist에서 자르지 않고 0~1 MHz의 명시적 수치/마이크 모델 검증 범위를 사용합니다. Tone 합성에서는 원 analog 주파수, sampled asset 분석에서는 선택한 Scene/STFT의 baseband bin 주파수로 보간합니다. 중복 id, sampling alias mapping, 시간 구간과 참조 무결성은 packages/contracts/validation.js에서 추가로 검증합니다.

Array·Scene·Experiment는 1.0.0, sampling provenance와 band별 fold/localization metadata를 필수화한 Result는 1.1.0입니다. Result 1.0을 묵시적으로 변환하지 않습니다.

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 근사의 입력입니다.