qualia_audio/features/loudness/
k_weighting.rs1use crate::features::filters::biquad::BiquadCoeffs;
14
15pub fn k_weighting_coeffs(sample_rate: f32) -> (BiquadCoeffs, BiquadCoeffs) {
21 let fs = if sample_rate > 1.0 {
22 f64::from(sample_rate)
23 } else {
24 1.0
25 };
26 let shelf = BiquadCoeffs::from_etalon(etalon_signal::filter::design_k_weighting_stage1(fs));
27 let hp = BiquadCoeffs::from_etalon(etalon_signal::filter::design_k_weighting_stage2(fs));
28 (shelf, hp)
29}
30
31#[cfg(test)]
32mod tests {
33 use super::*;
34 use crate::features::filters::biquad::BiquadState;
35 use core::f32::consts::PI as PI32;
36
37 #[test]
38 fn matches_bs1770_reference_at_48k() {
39 let (shelf, hp) = k_weighting_coeffs(48_000.0);
41 assert!(
42 (shelf.b0 - 1.535_124_9).abs() < 1e-3,
43 "shelf.b0 {}",
44 shelf.b0
45 );
46 assert!(
47 (shelf.b1 - (-2.691_696_2)).abs() < 1e-3,
48 "shelf.b1 {}",
49 shelf.b1
50 );
51 assert!(
52 (shelf.b2 - 1.198_392_8).abs() < 1e-3,
53 "shelf.b2 {}",
54 shelf.b2
55 );
56 assert!(
57 (shelf.a1 - (-1.690_659_3)).abs() < 1e-3,
58 "shelf.a1 {}",
59 shelf.a1
60 );
61 assert!(
62 (shelf.a2 - 0.732_480_8).abs() < 1e-3,
63 "shelf.a2 {}",
64 shelf.a2
65 );
66 assert_eq!(hp.b0, 1.0);
67 assert_eq!(hp.b1, -2.0);
68 assert_eq!(hp.b2, 1.0);
69 assert!((hp.a1 - (-1.990_047_5)).abs() < 1e-3, "hp.a1 {}", hp.a1);
70 assert!((hp.a2 - 0.990_072_3).abs() < 1e-3, "hp.a2 {}", hp.a2);
71 }
72
73 fn k_gain(sr: f32, freq: f32) -> f32 {
75 let (shelf, hp) = k_weighting_coeffs(sr);
76 let (n, skip) = (16_384usize, 4_096usize);
77 let mut s1 = BiquadState::new();
78 let mut s2 = BiquadState::new();
79 let (mut ein, mut eout, mut cnt) = (0.0f64, 0.0f64, 0.0f64);
80 for i in 0..n {
81 let x = (2.0 * PI32 * freq * i as f32 / sr).sin();
82 let y = s2.process_sample(&hp, s1.process_sample(&shelf, x));
83 if i >= skip {
84 ein += (x * x) as f64;
85 eout += (y * y) as f64;
86 cnt += 1.0;
87 }
88 }
89 ((eout / cnt).sqrt() / (ein / cnt).sqrt()) as f32
90 }
91
92 #[test]
93 fn one_khz_gain_is_slightly_positive_db() {
94 let g = k_gain(48_000.0, 1_000.0);
96 let db = 20.0 * g.log10();
97 assert!((-0.5..1.5).contains(&db), "1 kHz K-gain {db} dB");
98 }
99
100 #[test]
101 fn sub_bass_is_attenuated() {
102 let g = k_gain(48_000.0, 20.0);
104 assert!(g < 0.6, "20 Hz gain {g}");
105 }
106}