Skip to main content


PyPI version Documentation Status CircleCI Binder

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 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
  • 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 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: AES standard for file exchange - Spatial acoustic data file format, Audio Engineering Society, Inc., New York, NY, USA. Available from the AES standards store.

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: 10.17743/jaes.2022.0026

Metadata

Release files for sofar 1.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sofar 1.3.0
File Size Uploaded
sofar-1.3.0.tar.gz 384.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for sofar 1.3.0
File Interpreter ABI Platform
sofar-1.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 825.9 kB

Release files / sofar-1.3.0.tar.gz

Download URL sofar-1.3.0.tar.gz
Size 384.8 kB
Tags Source
SHA-256 checksum
How to use checksums
b1fb159131b1668db9029f6f2bb4fbb14b252b53e0b8b474aeeb60d3c00d4d04
BLAKE2b-256 checksum
How to use checksums
bb005d4e4ba0fce30616603f2f42d4ca80075802afddb85272e8de82397f6898
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release files / sofar-1.3.0-py3-none-any.whl

Download URL sofar-1.3.0-py3-none-any.whl
Size 441.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
61e0a0fa608da9a846f837cfb65bff0c5252c40ab0d2068dd376609d22ec1190
BLAKE2b-256 checksum
How to use checksums
221982a89c7e4dbd0d7a9c157f9e1af7b988e73e2ea328c0e6b3d99369bb0677
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.14

Release history Release notifications | RSS feed

This release

1.3.0 This release

2 release files

1.2.3

2 release files

1.2.2

2 release files

1.2.1

2 release files

1.2.0

2 release files

1.1.4

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.0.0

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.0

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page