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

Source: [SHroom: A Python Framework for Ambisonics Room Acoustics Simulation and Binaural Rendering](<https://www.sota2.com/research/paper/69cb54fc0636e5bf4afc9e65>)

Collection index: [llms.txt](<https://www.sota2.com/research/llms.txt>)

Data updated: 2026-04-01T05:00:04.436Z

Authors: Yhonatan Gayer

Published: 2026-03-28T17:23:51.000Z

## 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=30$ reference, \\textbf{shroom} with Magnitude Least Squares (MagLS) achieves perceptual transparency (2.02~dB Log Spectral Distance (LSD) at $N=5$, within the 1--2~dB Just Noticeable Difference (JND)) while its fixed-once decode amortises over multiple sources ($K=1$-to-$8$: slowdown narrows from $7\\times$ to $3.1\\times$). For dynamic head rotation, \\textbf{shroom} applies a Wigner-D multiply at $\<1$~ms/frame, making it the only architecturally viable real-time choice.

## Recorded benchmark results

A research result applies to its stated dataset, split, metric and evaluation configuration. Compare like-for-like settings, preserve the metric's unit and direction, and distinguish paper-reported results from independent reproduction. The best result recorded here is not a claim of exhaustive, current global coverage.

- [Binaural rendering on Neumann KU 100 HRTF database](<https://www.sota2.com/research/sota/binaural-rendering-on-neumann-ku-100-hrtf-database.md>): Binaural rendering; Neumann KU 100 HRTF database; LSD L (dB): 1.61.

## Original sources and implementation

[Original paper](<https://arxiv.org/abs/2603.27342>)

[PDF](<https://arxiv.org/pdf/2603.27342.pdf>)
