qualia_audio/features/spectral/
power_spectrum.rs1use crate::features::fft::real_fft_magnitude;
4use crate::types::AudioError;
5
6pub fn power_spectrum(
22 input: &[f32],
23 scratch: &mut [f32],
24 out_power: &mut [f32],
25) -> Result<(), AudioError> {
26 real_fft_magnitude(input, scratch, out_power)?;
27 let bins = input.len() / 2 + 1;
28 for p in out_power.iter_mut().take(bins) {
29 *p *= *p;
30 }
31 Ok(())
32}
33
34#[cfg(test)]
35mod tests {
36 use super::*;
37 use core::f32::consts::TAU;
38
39 #[test]
40 fn dc_power_is_magnitude_squared() {
41 let n = 16usize;
42 let input = vec![1.0f32; n];
43 let mut scratch = vec![0.0f32; 2 * n];
44 let mut power = vec![0.0f32; n / 2 + 1];
45 power_spectrum(&input, &mut scratch, &mut power).expect("power");
46 assert!((power[0] - (n * n) as f32).abs() < 1e-2, "dc={}", power[0]);
48 for p in &power[1..] {
49 assert!(*p < 1e-3);
50 }
51 }
52
53 #[test]
54 fn tone_power_concentrates_in_bin() {
55 let n = 1024usize;
56 let fs = 44_100.0f32;
57 let k0 = 40usize;
58 let freq = k0 as f32 * fs / n as f32;
59 let input: Vec<f32> = (0..n).map(|i| (TAU * freq * i as f32 / fs).cos()).collect();
60 let mut scratch = vec![0.0f32; 2 * n];
61 let mut power = vec![0.0f32; n / 2 + 1];
62 power_spectrum(&input, &mut scratch, &mut power).expect("power");
63 let mut peak = 1usize;
64 for (b, p) in power.iter().enumerate().skip(1) {
65 if *p > power[peak] {
66 peak = b;
67 }
68 }
69 assert_eq!(peak, k0, "peak power in bin {k0}, found {peak}");
70 assert!(power.iter().all(|p| *p >= 0.0));
72 }
73
74 #[test]
75 fn rejects_non_power_of_two() {
76 let input = vec![0.0f32; 6];
77 let mut scratch = vec![0.0f32; 12];
78 let mut power = vec![0.0f32; 4];
79 assert_eq!(
80 power_spectrum(&input, &mut scratch, &mut power),
81 Err(AudioError::InvalidParameter)
82 );
83 }
84}