qualia_audio/features/spectral/
complexity.rs1use crate::features::peaks::detect_peaks;
4use crate::types::AudioError;
5
6pub fn spectral_complexity(
25 mag: &[f32],
26 threshold: f32,
27 min_distance: usize,
28 scratch_pos: &mut [f32],
29 scratch_mag: &mut [f32],
30) -> Result<usize, AudioError> {
31 detect_peaks(mag, threshold, min_distance, scratch_pos, scratch_mag)
32}
33
34#[cfg(test)]
35mod tests {
36 use super::*;
37
38 #[test]
39 fn single_tone_low_complexity() {
40 let mut mag = [0.0f32; 32];
42 mag[9] = 0.5;
43 mag[10] = 1.0;
44 mag[11] = 0.5;
45 let mut pos = [0.0f32; 8];
46 let mut mg = [0.0f32; 8];
47 let c = spectral_complexity(&mag, 0.25, 1, &mut pos, &mut mg).expect("complexity");
48 assert_eq!(c, 1, "complexity={c}");
49 }
50
51 #[test]
52 fn polyphonic_higher_complexity() {
53 let mut mag = [0.0f32; 32];
55 for c in [5usize, 15, 25] {
56 mag[c - 1] = 0.4;
57 mag[c] = 1.0;
58 mag[c + 1] = 0.4;
59 }
60 let mut pos = [0.0f32; 8];
61 let mut mg = [0.0f32; 8];
62 let c = spectral_complexity(&mag, 0.25, 1, &mut pos, &mut mg).expect("complexity");
63 assert_eq!(c, 3, "complexity={c}");
64 }
65
66 #[test]
67 fn threshold_suppresses_weak_peaks() {
68 let mut mag = [0.0f32; 32];
69 mag[5] = 0.1; mag[15] = 1.0; let mut pos = [0.0f32; 8];
72 let mut mg = [0.0f32; 8];
73 let c = spectral_complexity(&mag, 0.5, 1, &mut pos, &mut mg).expect("complexity");
74 assert_eq!(c, 1, "complexity={c}");
75 }
76
77 #[test]
78 fn rejects_nan_threshold() {
79 let mag = [0.0f32, 1.0, 0.0];
80 let mut pos = [0.0f32; 2];
81 let mut mg = [0.0f32; 2];
82 assert_eq!(
83 spectral_complexity(&mag, f32::NAN, 1, &mut pos, &mut mg),
84 Err(AudioError::InvalidParameter)
85 );
86 }
87}