Welcome
Welcome to the Treble SDK documentation! The Treble SDK provides a unified programmatic interface to a suite of acoustic simulation methods spanning geometric, wave-based, and hybrid solvers. It is designed to accommodate workflows of varying complexity, from single-query room acoustic predictions to large-scale batch computations and dynamic scene rendering within a single Python-based interface. This section documents the SDK's capabilities, the application domains it addresses, and the specific computational problems it is built to solve.
What can I use it for?
The SDK may be used in the workflows of a variety of audio and acoustic engineering domains. The following groups highlight a few common use cases. For further applications, please visit our Applications and use cases section.
ML & data generation
Synthetic SRIR dataset generation. Enriched acoustic parameter data for model training. Physics-informed feature extraction. Augmentation for perceptual model pipelines.
Devices
Device-specific DRTF characterisation. Microphone array response simulation. Device-in-room interaction modelling. Re-rendering across device configurations.
Spatial audio & DSP
Physics-based auralisations. Dynamic source and listener trajectory rendering. Acoustic scene generation for algorithm benchmarking. DSP algorithm validation cases. Beamforming and array processing prototypes.
Room acoustics
Architectural and interior acoustic prediction. Sound system placement and tuning. Acoustic parameter evaluations.
Where do I start?
Jump into some simple workflows by following your chosen link.
Your First Room Simulation
A simple room simulation, step by step.
Your First Audio Scene
A simple audio scene, step by step.
What does it do?
Wave-based simulation
Finite element method solvers for low-frequency domains where phase effects and modal behaviour are physically significant.
Geometric acoustics
Image source and ray-radiosity methods for high-frequency propagation in arbitrary geometries.
Hybrid solver
Coupling of geometric and wave-based methods across user-defined crossover bands for accurate broadband acoustic simulation.
Impulse response synthesis
Full-spectrum spatial room impulse response (SRIR) generation for arbitrary source-receiver configurations.
DRTF simulation
Device-related transfer function computation for transducer and loudspeaker array characterisation.
Bulk IR computation and post-processing
Efficient and parallelised batch simulation and post-processing for dataset generation and parameterisation workflows.
ML workflow integration
Structured outputs compatible with machine learning pipelines for data augmentation and model training.
Auralisation and dynamic scenes
Moving source and receiver trajectories with time-varying scene reconstruction, and perceptual rendering via binaural, device, or Ambisonics based convolution of SRIR outputs.
Analysis and visualisation
Calculation of room acoustic parameters, energy decay curves, and device-related directivity plots.