IRAnalyzer
Room Impulse Response (IR) analysis and visualization tool.
IRAnalyzer validates the accuracy of IRs generated by the exaSound (STCoreV2) geometric acoustic simulator and compares them against measured data or results from other simulators. It consists of two executables.
Components
| Module | Executable | Description |
|---|---|---|
| simulator | rir_sim | Standalone Embree-based path tracing IR synthesizer used as a validation baseline |
| viewer | rir_viewer | Real-time visualization and analysis tool based on SDL3 + ImGui |
Build
Requirements
- CMake 3.20+
- C++20-compatible compiler
- macOS 13.0+ (Apple platforms are supported first)
Most dependencies are downloaded automatically through CMake FetchContent.
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
Optional Dependencies
| Dependency | CMake variable | Use |
|---|---|---|
| Intel Embree 4 | system install | rir_sim path tracing |
| exaSound (STCoreV2) | STCORE_SOURCE_DIR | real-time geometric acoustic simulation backend |
| SketchUp C SDK | SKETCHUP_SDK_DIR | direct .skp loading |
# exaSound integration
cmake -S . -B build \
-DSTCORE_SOURCE_DIR=/path/to/STCoreV2/exaSound \
-DCMAKE_BUILD_TYPE=Release
# Add SketchUp SDK
cmake -S . -B build \
-DSKETCHUP_SDK_DIR=/path/to/sketchup-sdk-mac \
-DCMAKE_BUILD_TYPE=Release
Tests
cd build && ctest
Viewer (rir_viewer)
The viewer uses an ImGui docking-based multi-panel interface.
| Panel | Function |
|---|---|
| 3D Viewport | scene geometry, acoustic paths, debug visualization |
| Control | simulation parameters such as ray resolution, max depth, and tuning |
| View | scene statistics and render options such as wireframe and face culling |
| Materials | 8-band absorption and scattering coefficients, automatic BRAS CSV mapping |
Simulator (rir_sim)
The simulator is an independent synthesizer that traces paths and synthesizes IRs directly with Embree. It is used as a reference baseline for validating STCoreV2 under the same scene and material conditions.
Use Scenarios
- Regression validation — compare IR differences before and after STCoreV2 changes
- Algorithm comparison — deterministic tracing (
rir_sim, Embree) vs statistical sound propagation (STCoreV2) - Material tuning — adjust 8-band absorption and visualize immediately
- Measured-data comparison — overlay measured IR and simulated IR in the same coordinate system
References
- STCoreV2 — simulation target
- ExaTools Overview