hrtfpykit.plots

Description:

hrtfpykit.plots provides figures for inspecting HRTF and HRIR data. It turns HRTF objects, comparisons between HRTF objects, and spherical harmonic reconstruction results into readable figures with consistent layouts, axes, labels, legends, and titles. Its role is to make the acoustic state of the library visible: source positions, ear channels, time samples, frequency bins, magnitude and amplitude responses, energy time curves, interaural cues, spectral differences, and spherical harmonic errors.

Single HRTF plots are ordinary functions in this module. They receive a loaded HRTF object as their first argument and read the active IR, TF, and Sources views. That keeps figures aligned with source selections, transforms, padding, gain changes, and domain conversions already applied to the object without making plotting part of the core HRTF class.

Comparison plots extend the same pattern to multiple HRTF objects. They resolve positions, ears, and frequency ranges against each object, then show magnitude, amplitude, ITD, ILD, and LSD relationships in a shared figure. Spherical harmonic plotting functions connect sht workflows back to an HRTF object by visualizing reconstructed spectra and reconstruction error.

With these tools, users can plot one loaded HRTF, compare several HRTFs, inspect source grids and spatial planes, review magnitude, amplitude, energy time, ITD, ILD, and LSD relationships, visualize spatial cue differences, and evaluate spherical harmonic reconstructions with the same coordinate, domain, and plotting conventions used by the rest of hrtfpykit.

Content: