Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/marians/audiocalc
A few audio/sound calculation tools for Python
https://github.com/marians/audiocalc
Last synced: 27 days ago
JSON representation
A few audio/sound calculation tools for Python
- Host: GitHub
- URL: https://github.com/marians/audiocalc
- Owner: marians
- License: mit
- Created: 2013-11-22T09:48:54.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2015-05-27T05:19:45.000Z (over 9 years ago)
- Last Synced: 2024-04-23T17:20:05.776Z (7 months ago)
- Language: Python
- Size: 290 KB
- Stars: 3
- Watchers: 0
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
audiocalc
=========
A few audio/sound calculation utilities for Python.
Caution: I am not a sound engineer. This comes without any sort of guarantee. See file "LICENSE" for details.
If you find a bug, please post a remark in the issues section. Thanks!
## Function overview
### damping
Caclulates the damping (dissipation, absorption) in dependence of air pressure, temperature, humidity and frequency. The return value is the damping in dB/m (decibel per meter).
```python
>>> d = audiocalc.damping(temp=20, relhum=80, freq=8000)
>>> d
0.06945538
```
### total_level
Given sound pressure levels for octave frequencies, calculates the total sound pressure level.
```python
>>> octave_frequencies = {
'f63': 71.5,
'f125': 68.5,
'f250': 64,
'f500': 58,
'f1000': 53,
'f2000': 47,
'f4000': 40,
'f8000': 32}
>>> audiocalc.total_level(octave_frequencies)
73.91092323
```
### total_rated_level
Given sound pressure levels for octave frequencies, calculates the A-rated total sound pressure level.
```python
>>> octave_frequencies = {
'f63': 71.5,
'f125': 68.5,
'f250': 64,
'f500': 58,
'f1000': 53,
'f2000': 47,
'f4000': 40,
'f8000': 32}
>>> audiocalc.total_rated_level(octave_frequencies)
60.5054659
```
### distant_level
Given a reference sound pressure level (`reference_level`) in a `reference_distance`, this function calculates the sound pressure level at a certain distance.
The unit for sound level parameter and return value is dB, the unit for distances is meters.
Assumptions:
* No air damping
* The sound source is point-shaped
* energy spreads equally to all directions
```python
>>> l = audiocalc.distant_level(
reference_level=100,
distance=100,
reference_distance=1)
>>> l
60.00000000000001
```
### distant_total_damped_rated_level
This combines the powers of some of the functions above. It calculates the total A-rated sound pressure level, based on a reference distance and octave sound pressure levels, given a distance, temperature and relative humidity.
```python
>>> octave_frequencies = {
'f63': 71.5,
'f125': 68.5,
'f250': 64,
'f500': 58,
'f1000': 53,
'f2000': 47,
'f4000': 40,
'f8000': 32}
>>> audiocalc.distant_total_damped_rated_level(
octave_frequencies=octave_frequencies,
reference_distance=300,
distance=2000,
temp=20, relhum=80)
40.860935587070635
```
### level_to_power
Converts logarithmic sound pressure level (dB) values to metric power (W/sqm) values.
```python
>>> audiocalc.level_to_power(100)
0.01
```
## Development
Execute the unit tests using
python -m audiocalc.test
A performance test script for the `distant_total_damped_rated_level` function (which makes use of other functions as well) can be executed like this:
python -m audiocalc.benchmark_damping
In order to activate profiling of the benchmark, add the `-p` parameter.
python -m audiocalc.benchmark_damping -p
## Credits
* Christopher Arndt has helped with tremendous speedup through the use of Cython
* Some basic calculations have been adapted from http://www.sengpielaudio.com/
## Like audiocalc?
Feel free to [tip me](https://www.gittip.com/marians/)!