Note: This script and documentation were created with the assistance of AI.
This Python script analyzes and visualizes the spatial energy distribution of electroacoustic multi-channel compositions over time. It is designed for composers and sound artists working in spatial audio and Ambisonics who want to evaluate the envelopment and spatial trajectories of their works.
The tool processes Ambisonics B-Format audio files (ACN/SN3D) and computes high-resolution 2D heatmaps for Azimuth (horizontal plane) and Elevation (upper hemisphere). It seamlessly supports Higher Order Ambisonics (HOA).
- Plane Wave Decomposition (Beamforming): Mathematically precise spatial resolution using covariance matrix computation.
- Automatic Format Detection: Supports 1st (4ch), 3rd (16ch), 5th (36ch), and 7th (64ch) order Ambisonics.
- HTML Reporting: Generates a scrollable HTML file with embedded Matplotlib graphs.
- Configurable GUI:
- Selectable temporal resolution (25ms, 50ms, 100ms windowing).
- Selectable visual layout (Vertical = waterfall view, Horizontal = timeline to the right).
The script is written in Python and requires specific libraries for audio processing and visualization.
pip install numpy scipy matplotlib soundfile