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)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sofar-1.3.0.tar.gz | 384.8 kB | Without provenance | Details for sofar-1.3.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sofar-1.3.0-py3-none-any.whl | Python 3 | none | any | Details for sofar-1.3.0-py3-none-any.whl |
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
|
Security for sofar 1.3.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.