Skip to main content

Maybe the most complete python package for SOFA files so far

Project description


PyPI version Documentation Status CircleCI

Sofar is maybe the most complete Python package for the SOFA file format so far. SOFA files store spatially distributed acoustic data such as impulse responses or transfer functions. They are defined by the AES69-2022 standard (see references). These are the key features of sofar

  • Read, edit, and write SOFA files
  • Add custom attributes to SOFA files
  • Full Verification of the content of a SOFA files against AES69-2022
  • Upgrade data that uses outdated SOFA conventions
  • Open license allows unrestricted use
  • sofar is tested using continuous integration on
  • Uses a complete definition of the AES69-2022 standard (see references) maintained at sofa_conventions

Getting Started

The sofar and SOFA notebook gives an overview of the most important sofar functionality and is a good starting point. For processing and visualizing data inside SOFA files, we recommend the pyfar package that can read SOFA files through pyfar.io.read_sofa and the in-depth examples contained in the pyfar example gallery. Check out read the docs for a complete documentation of sofar. A more detailed introduction to the SOFA file format is given by Majdak et. al. 2022 (see references below). All information is also bundled at pyfar.org.

Installation

Use pip to install sofar

pip install sofar

(Requires Python >= 3.8)

If the installation fails, please check out the help section.

Contributing

Refer to the contribution guidelines for more information.

References

AES69-2022: AES standard for file exchange - Spatial acoustic data file format, Audio Engineering Society, Inc., New York, NY, USA. (https://www.aes.org/publications/standards/search.cfm?docID=99)

P. Majdak, F. Zotter, F. Brinkmann, J. De Muynke, M. Mihocic, and M. Noisternig, "Spatially Oriented Format for Acoustics 2.1: Introduction and Recent Advances", J. Audio Eng. Soc., vol. 70, no. 7/8, pp. 565-584, Jul. 2022. DOI: https://doi.org/10.17743/jaes.2022.0026

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sofar-1.2.0.tar.gz (374.0 kB view details)

Uploaded Source

Built Distribution

sofar-1.2.0-py2.py3-none-any.whl (129.2 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file sofar-1.2.0.tar.gz.

File metadata

  • Download URL: sofar-1.2.0.tar.gz
  • Upload date:
  • Size: 374.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for sofar-1.2.0.tar.gz
Algorithm Hash digest
SHA256 ace5d356de2e2eb32e60058f6301fc434b092d8d9d964a3cffd793938895cb26
MD5 a26de8717dc0d8981f95e1b17bf14f72
BLAKE2b-256 89bb13a634d42da03932880528614b1dcc5477c7c782cae80b73dcaea6979d80

See more details on using hashes here.

File details

Details for the file sofar-1.2.0-py2.py3-none-any.whl.

File metadata

  • Download URL: sofar-1.2.0-py2.py3-none-any.whl
  • Upload date:
  • Size: 129.2 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.6

File hashes

Hashes for sofar-1.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 7591460f59c1fb806391edbebda6b65362380e56dc0b1779f5350b20a4bbf8fa
MD5 b721e25719f2c4ca0d3e877267147595
BLAKE2b-256 7245122839e3f040feb3ccaf4c3f7c6f4cb959c889c68c5c5666f6f0f288ec72

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page