English

SHroom: A Python Framework for Ambisonics Room Acoustics Simulation and Binaural Rendering

Audio and Speech Processing 2026-03-31 v1 Sound

Abstract

Spherical Harmonics ROOM), an open-source Python library for room acoustics simulation using Ambisonics, available at https://github.com/Yhonatangayer/shroom and installable via \texttt{pip install pyshroom}. \textbf{shroom} projects image-source contributions onto a Spherical Harmonics (SH) basis, yielding a composable pipeline for binaural decoding, spherical array simulation, and real-time head rotation. Benchmarked against \texttt{pyroomacoustics} with an N=30N=30 reference, \textbf{shroom} with Magnitude Least Squares (MagLS) achieves perceptual transparency (2.02~dB Log Spectral Distance (LSD) at N=5N=5, within the 1--2~dB Just Noticeable Difference (JND)) while its fixed-once decode amortises over multiple sources (K=1K=1-to-88: slowdown narrows from 7×7\times to 3.1×3.1\times). For dynamic head rotation, \textbf{shroom} applies a Wigner-D multiply at <1<1~ms/frame, making it the only architecturally viable real-time choice.

Keywords

Cite

@article{arxiv.2603.27342,
  title  = {SHroom: A Python Framework for Ambisonics Room Acoustics Simulation and Binaural Rendering},
  author = {Yhonatan Gayer},
  journal= {arXiv preprint arXiv:2603.27342},
  year   = {2026}
}
R2 v1 2026-07-01T11:42:24.149Z