python-acoustics
Legacy project. Archived by its authors; its last commit was in August 2023. Kept here for reference. Its code may follow an older edition and may not run with current software.
General Python library for acousticians, published on PyPI as acoustics. For this list it is relevant for its tonal audibility and tonal adjustment after ISO 1996-2:2007. Archived in February 2024 and continued as acoustic-toolbox.
| Repository | https://github.com/python-acoustics/python-acoustics |
|---|---|
| Documentation | https://python-acoustics.github.io/python-acoustics/ |
| Language | Python |
| Kind | Library/Toolbox Functions to call from your own code: a Python package, a MATLAB toolbox, or a C, C++, C#, Rust or Julia library. |
| Group | legacy Archived, or no commit for three years or more. Kept for reference. The code may follow an older edition and may not run with current software. |
| Licence | BSD-3-Clause |
| Package | PyPI acoustics |
| Install | pip install acoustics |
| Latest release | 0.2.6 (2022-07) |
| Last commit | 2023-08-20 archived |
| GitHub stars | 563 |
| Maintainers | Frederik Rietdijk |
| AI assistance | not stated |
| How to cite | The project does not say how to cite it. Cite the repository with the version or commit you used. |
| Entry checked | 8 October 2026 |
What it implements
| Metric | Edition | Functions | Validation (as stated) | Notes |
|---|---|---|---|---|
| Tonal audibility (ISO 1996-2) | ISO 1996-2:2007 tonal audibility and tonal adjustment | Tonality, tonal_audibility, tonal_adjustment | own tests only | legacy Module acoustics.standards.iso_1996_2_2007. The Tonality docstring uses the title of Annex C ("Objective method for assessing the audibility of tones in noise"), though the code does not name the annex. |
How it was validated
As reported by the project; LISQM has not run the code. Two implementations that agree can still share the same error. Kinds of evidence.
- Tonal audibility (ISO 1996-2) · ISO 1996-2:2007
own tests only
- A test of the examples in the standard, using DELTA tone files, is commented out.
Notes
- The successor is acoustic-toolbox, which continues the same code.
- It has no loudness, sharpness or roughness modules.
Before you rely on it
- The repository was archived on 2024-02-07 and is read-only.
- A fix to the default window of the tonality code (2023-08-20) is on the default branch but not in the last PyPI release (0.2.6, July 2022).
- It follows ISO 1996-2:2007, which has been withdrawn; ISO 1996-2:2017 replaced its tonal audibility method with those of Annexes J and K.
Sources
- https://github.com/python-acoustics/python-acoustics
- https://github.com/python-acoustics/python-acoustics/blob/master/README.md
- https://github.com/python-acoustics/python-acoustics/blob/master/acoustics/standards/iso_1996_2_2007.py
- https://github.com/python-acoustics/python-acoustics/blob/master/tests/standards/test_iso_1996_2_2007.py
- https://pypi.org/project/acoustics/
- https://github.com/python-acoustics/python-acoustics/blob/master/docs/conf.py