hos

Python toolbox and realtime code for reproducing spatial audio using Higher-Order Stereophony (HOS).

https://github.com/jacobhollebon/hos

Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (14.4%) to scientific vocabulary

Keywords

3daudio ambisonics higherorderstereophony hos python spatialaudio stereo stereophony visr
Last synced: 6 months ago · JSON representation ·

Repository

Python toolbox and realtime code for reproducing spatial audio using Higher-Order Stereophony (HOS).

Basic Info
  • Host: GitHub
  • Owner: jacobhollebon
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 118 KB
Statistics
  • Stars: 3
  • Watchers: 1
  • Forks: 0
  • Open Issues: 1
  • Releases: 0
Topics
3daudio ambisonics higherorderstereophony hos python spatialaudio stereo stereophony visr
Created about 2 years ago · Last pushed 8 months ago
Metadata Files
Readme Citation

README.md

Higher-Order Stereophony

Python toolbox and realtime code for reproducing spatial audio using Higher-Order Stereophony (HOS).

HOS is a generalised extension to classic stereophony, which (in a similar manner to Higher-Order Ambisonics) extends stereo to higher order soundfield reproduction using generalised arrays of loudspeakers. The approach may be applied to soundfield capture and synthesis, soundfield manipulation and reproduction over loudspeaker arrays or binaural.

HOS reproduces the soundfield accurately over a line defined by the intramural axis (along which lies the listeners ears). Dynamic HOS extends HOS to adapt this line of reproduction based on real-time head tracking of their listener's position.

Currently, this repository focuses on loudspeaker rendering of objects over HOS/Dynamic HOS. As further work is published this will be extended to include binaural rendering and as well as rendering of Higher-Order Ambisonics using HOS.

For full details of HOS, please see the work listed in citations.

Citation

We kindly ask to acknowledge the use of this software in publications or software.

Jacob Hollebon and Filippo Maria Fazi, “Higher-order stereophony,” IEEE/ACM Transactions on Audio, Speech, and Language Processing, vol. 31, pp. 2872–2885, 2023

Folder Structure

The repository is split into two separate python packages. The realtime package has the pre-requisite of VISR, see below for more information.

HOS

Core python functions required for HOS calculations, loudspeaker gain definitions, geometry handling and simulations.

HOSrealtime

Code to perform realtime processing of HOS using the python implementation of the Versatile Interactive Realtime Renderer (VISR) framework.

VISR

VISR is no longer actively supported by the developers, but the source code can be found here along with documentation and a tutorial. Installers for windows, linux and intel Macs (silicon chips not supported) are available here.

Installation

You may choose to not instal the HOSrealtime package if you do not have a working VISR install.

  • git clone https://github.com/jacobhollebon/hos/
  • cd hos
  • pip install .
  • cd ..
  • cd hosrealtime
  • pip install .

Owner

  • Name: Jacob Hollebon
  • Login: jacobhollebon
  • Kind: user

Researcher in the Virtual Acoustics and Audio Engineering Team, ISVR, University of Southampton

Citation (citations.txt)

# Higher-Order Stereophony:
[1] J. Hollebon “Higher-order stereophony, Ph.D. Thesis, ISVR, Univ. Southampton, UK, 2023. Available: https://eprints.soton.ac.uk/476263/
[2] J. Hollebon and F. M. Fazi, “Higher-order stereophony,” IEEE/ACM Transactions on Audio, Speech, and Language Processing, vol. 31, pp. 2872–2885, 2023
[3] J. Hollebon and F. M. Fazi, “Spatial audio panning with elevated sources using horizontal-only reproduction loudspeakers,” in I3DA: International Conference on Immersive and 3D Audio, 2023.
[4] J. Hollebon and F. M. Fazi, “Dynamic Higher-order stereophony,” IEEE/ACM Transactions on Audio, Speech, and Language Processing, vol. 32, pp. 2073–2084, 2024
[5] J. Hollebon and F. M. Fazi, “Efficient Rendering Of HOA Using HOS And Magnitude Least Squares,” in AES 5th International Conference on Audio for Virtual and Augmented Reality, 2024.
[6] J. Hollebon, F. M. Fazi; Binaural rendering using higher-order stereophony. J. Acoust. Soc. Am. 1 February 2025; 157 (2): 1241–1251. https://doi.org/10.1121/10.0035793

# Generalised Low Frequency Spatial Audio:
[1] J. Hollebon and F. M. Fazi, “Generalised low frequency 3d audio reproduction over loudspeakers,” in AES 148th Convention, 2020.
[2] J. Hollebon and F. M. Fazi, “Experimental study of various methods for low frequency spatial audio reproduction over loudspeakers,” in I3DA: International Conference on Immersive and 3D Audio, 2021.

GitHub Events

Total
  • Issues event: 1
  • Watch event: 1
  • Push event: 10
Last Year
  • Issues event: 1
  • Watch event: 1
  • Push event: 10