GSound-SIR: A Spatial Impulse Response Ray-Tracing and High-order Ambisonic Auralization Python Toolkit
Yongyi Zang, Qiuqiang Kong · 2025
Read GSound-SIR: A Spatial Impulse Response Ray-Tracing and High-order Ambisonic Auralization Python Toolkit by Yongyi Zang, Qiuqiang Kong (2025) in the Tower of Babel, a free online library of public-domain works preserved in clean, searchable text. No sign-up. The full text is served as a plain-text file at a predictable URL, where text is present: https://antarctic-labs.com/tower-of-babel/arxiv-2503-17866.txt.
Introduction
Yongyi Zang and Qiuqiang Kong build GSound-SIR, a Python toolkit that fakes how sound acts in a room, with full place sense. Their paper is from two thousand twenty-five.
True, fast fakes of a room's echo are key for spatial sound work. Past ray tools act as black boxes and give just the end echo, with no sight of the path data. The new toolkit opens up the raw rays, up to vast counts of them, for deep study of sound paths. It can turn rays into high-order round-format echoes that hold sound place well. A filter that keeps the strongest rays cuts the work and speeds runs.
Catalog record
| CREATOR | Yongyi Zang, Qiuqiang Kong |
|---|---|
| YEAR | 2025 |
| COLLECTION | PAPERS |
| FORMAT | TXT |
| FILE SIZE | 22 KB |
| VERSION | 1.0 |
| LICENSE | http://creativecommons.org/licenses/by/4.0/ |
| RIGHTS | CC BY |
| SOURCE | arXiv |
Source: https://arxiv.org/abs/2503-17866
Browse the full library · About the Tower of Babel
Full text
The opening of the work, from the library's hosted text:
GSound-SIR: A Spatial Impulse Response Ray-Tracing and High-order Ambisonic Auralization Python Toolkit Yongyi Zang, Qiuqiang Kong Abstract Accurate and efficient simulation of room impulse responses is crucial for spatial audio applications. However, existing acoustic ray-tracing tools often operate as black boxes and only output impulse responses (IRs), providing limited access to intermediate data or spatial fidelity. To address those problems, this paper presents GSound-SIR, a novel Python-based toolkit for room acoustics simulation that addresses these limitations. The contribution of this paper includes the follows. First, GSound-SIR provides direct access to up to millions of raw ray data points from simulations, enabling in-depth analysis of sound propagation paths that was not possible with previous solutions. Second, we introduce a tool to convert acoustic rays into high-order Ambisonic impulse response synthesis, capturing spatial audio cues with greater fidelity than standard techniques. Third, to enhance efficiency, the toolkit implements an energy-based filtering algorithm and can export only the top-X or top-X-% rays. Fourth, we propose to store the simulation results into Parquet formats, facilitating fast data I/O and seamless integration with data analysis workflows. Together, these features make GSound-SIR an advanced, efficient, and modern foundation for room acoustics research, providing researchers and developers with a powerful new tool for spatial audio exploration. We release the library under Apache 2.0 License at https://github.com/yongyizang/GSound-SIR . 1 Introduction “A craftsman who wishes to do his work well must first sharpen his tools.” — Confucius [ 16 ] Spatial audio research in areas like virtual reality (VR) and gaming often uses spatial impulse responses (SIRs) [ 8 ] to model how sound propagates over space and time from an impulsive source. By convolving a signal with an SIR, it is possible to recreate auditory cues specific to the target environment. There are three main methods to derive SIRs, including the image-source method, ray tracing, and the finite-difference time-domain (FDTD) method. The image-source method can be inaccurate for complex geometries, while FDTD simulations are computationally expensive for large spaces. Ray tracing, however, often provides the best balance between computational efficiency and acoustic accuracy [ 7 ] . A typical ray-tracing workflow for spatial audio involves three steps. First, the 3D scene is loaded, acoustic properties are assigned to surfaces, and the positions of the source and listener are defined. Next, rays are emitted from the source to gather raw data for each ray path, including arrival time, energy coefficients across frequency bands, and metadata. Finally, the collected ray data is auralized, often using Higher-Order Ambisonics (HOA) or head-related transfer functions (HRTFs), to generate the final room impulse response. Although numerous open-source libraries implement ray tracing for acoustics, most are designed for end-to-end processing and directly output the final auralization. Notable examples include GSound [ 14 ] , which uses caching for real-time performance in gaming, and vaRays [ 10 ] , which efficiently supports HOA-based spatial audio rendering. However, these solutions typically do not expose intermediate ray data for inspection or modification, and they couple the simulation and auralization steps in ways that complicate adapting or substituting different rendering algorithms. In this paper, we introduce GSound-SIR , a Python library that extends and modifies GSound to decouple the ray generation step from the auralization step. We add a module to GSound for directly exporting the raw ray data and implement a standalone auralization module capable of producing up to ninth-order Ambisonics efficiently, although users can substitute their own rendering approaches. A key challenge in exposing raw ray data is the substantial input/output overhead of storing and retrieving large volumes of ray information. To address this, we offer energy-based filtering options that export only a subset of rays (e.g., the top-X or top-X% by energy), thereby reducing storage demands while preserving accurate energy reconstruction. To our knowledge, GSound-SIR is the first open-source framework to provide full access to intermediate ray-tracing data for spatial audio research. We release our supplementary code under the Apache 2.0 License (while GSound itself remains under a more restrictive academic license) and adopt Parquet-based data storage [ 18 ] for efficient reading and writing of intermediate results. In the following sections, we describe our modifications to GSound, detail our Python-based interface, and present empirical evaluations demonstrating the feasibility and accuracy of the proposed approach. The library, along with documentation and examples, will be made publicly available upon publication. 2 Related Work Sound propagation simulation has evolved along two main trajectories: numerical and geometric methods. We review key developments in both approaches, with a particular focus on geometric methods that inform our work. 2.1 Numeric Methods Early attempts at sound propagation simulation employed numerical approaches like finite-difference time-domain (FDTD) methods, which, while highly accurate, proved computationally intensive and impractical for real-time applications. Subsequent improvements, such as Adaptive Rectangular Decomposition (ARD) [ 13 ] , reduced simulation time through environment subdivision but still required significant computational resources. Direct-to-Indirect Acoustic Radiance Transfer [ 2 ] achieved real-time diffuse reflection simulation by adapting radiosity concepts from computer graphics, though at the cost of extensive preprocessing and static geometry requirements. 2.2 Geometric Methods Geometric approaches have proven more tractable for interactive applications due to their efficient calculations. The image-source method [ 1 ] provides high accuracy by recursively reflecting sources over scene geometry, but its exponential complexity with reflection depth limits practical application. Beam tracing [ 4 ] and frustum tracing [ 3 ] methods improved efficiency by propagating volumes rather than individual rays, though geometric complexity still posed performance challenges. Hybrid approaches like RESound [ 17 ] combined ray and frustum tracing to balance accuracy and performance. Modern systems have built upon these foundations while introducing novel optimizations. GSound [ 14 ] demonstrated viable real-time simulation through efficient caching, while EVERTims [ 11 ] integrated beam tracing with spatial audio rendering. Commercial systems like ODEON [ 9 ] refined hybrid approaches for professional applications, and more recently, vaRays [ 10 ] has focused on generating spatial room impulse responses in Ambisonic format. 2.3 Spatial Audio Representation The representation of spatial sound fields has evolved significantly since the introduction of Ambisonics. Higher-order implementations and alternative approaches like Directional Audio Coding [ 12 ] have improved spatial resolution while maintaining practical efficiency. Very recently, researchers have aimed to reconstruct ambisonic representations from mono or stereo signals [ 20 ] . 3 Implementations We build on GSound for its highly efficient and customizable ray-tracing engine, originally developed for gaming. Unlike traditional source-based methods, GSound employs backward ray tracing from the listener’s position. The processing pipeline of GSound consists of three main phases. To construct SIRs instead of IRs, we modified the GSound toolbox as follows. 3.1 Ray casting First, rays are cast in random spherical directions from the listener and traced through the environment to capture specular reflections up to a user-defined depth. These paths are efficiently managed via a hash table system that prevents duplicates and supports path caching , which substantially improves temporal coherence and reduces computational cost. However, path caching primarily reduces duplicates with moving subjects. As our primary concern is with stationary subjects, we disable caching to save space and caching-related computation time. In simulation, GSound cast both specular rays and diffuse rays . Specular rays reflect off