Skip to main content

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

ModuleExecutableDescription
simulatorrir_simStandalone Embree-based path tracing IR synthesizer used as a validation baseline
viewerrir_viewerReal-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

DependencyCMake variableUse
Intel Embree 4system installrir_sim path tracing
exaSound (STCoreV2)STCORE_SOURCE_DIRreal-time geometric acoustic simulation backend
SketchUp C SDKSKETCHUP_SDK_DIRdirect .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.

PanelFunction
3D Viewportscene geometry, acoustic paths, debug visualization
Controlsimulation parameters such as ray resolution, max depth, and tuning
Viewscene statistics and render options such as wireframe and face culling
Materials8-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