use-acoustics 0.1.0

Composable primitive acoustics utilities for Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80

# use-acoustics

Composable primitive acoustics utilities for Rust.

`use-acoustics` provides a small, self-contained v0.1 API for common sound-domain calculations:
frequency and period helpers, wavelength conversions, decibel conversions, sound pressure level,
sound intensity level, and simple speed of sound approximations.

## Relationship To RustUse

`use-wave` is the broader wave utility set. `use-acoustics` is the sound-specific sibling that
focuses on reusable primitives and small formulas for acoustics-oriented applications.

## Warning

The formulas in this crate are general-purpose approximations and convenience conversions. They
are not a replacement for specialized acoustic engineering software, calibrated measurements, or
standards-driven analysis.

## Installation

Crates.io:

```toml
[dependencies]
use-acoustics = "0.1"
```

Local path:

```toml
[dependencies]
use-acoustics = { path = "crates/use-acoustics" }
```

## Examples

```rust
use use_acoustics::prelude::*;

let wavelength = wavelength_meters(440.0, SPEED_OF_SOUND_AIR_20C_MPS).unwrap();
assert!((wavelength - 0.7795).abs() < 0.001);

let spl = sound_pressure_level_db(1.0).unwrap();
assert!((spl - 93.9794).abs() < 0.001);
```

```rust
use use_acoustics::prelude::*;

let amplitude_ratio = db_to_amplitude_ratio(20.0).unwrap();
let power_ratio = db_to_power_ratio(10.0).unwrap();

assert!((amplitude_ratio - 10.0).abs() < 1.0e-12);
assert!((power_ratio - 10.0).abs() < 1.0e-12);
```

## Module Overview

| Module       | Purpose                                                  |
| ------------ | -------------------------------------------------------- |
| `decibel`    | Decibel ratios plus SPL and SIL conversions              |
| `frequency`  | Frequency newtype, period, and angular frequency helpers |
| `wavelength` | Frequency and wavelength conversion helpers              |
| `pressure`   | Sound pressure newtype and SPL inverse conversion        |
| `intensity`  | Sound intensity newtype and SIL inverse conversion       |
| `speed`      | Speed of sound helpers                                   |
| `prelude`    | Re-exports for the main public API                       |

## Scope

- decibels and ratios
- sound pressure level and sound intensity level
- frequency, period, and angular frequency
- wavelength conversions
- speed of sound approximations

## Status

Early v0.1 API.