lasprs 0.9.1

Library for Acoustic Signal Processing (Rust edition, with optional Python bindings via pyo3)
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

//! Compute forward single sided amplitude spectra
use crate::config::*;
use realfft::{RealFftPlanner, RealToComplex};
use std::{fmt::Debug, sync::Arc};

#[derive(Clone)]
#[allow(clippy::upper_case_acronyms)]
pub struct FFT {
    // The fft engine
    fft: Arc<dyn RealToComplex<Flt>>,
    // Copy over time data, as it is used as scratch data in the fft engine
    timescratch: Vec<Flt>,
    // rounded down nfft/2
    half_nfft_rounded: usize,
    // nfft stored as float, this is how it is required most often
    nfftF: Flt,
}
impl Debug for FFT {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("Forward FFT engine, lenfth: {self.nfftF}").finish()
    }
}

impl FFT {
    /// Create new FFT from given nfft
    #[allow(dead_code)]
    pub fn newFromNFFT(nfft: usize) -> FFT {
        let mut planner = RealFftPlanner::<Flt>::new();
        let fft = planner.plan_fft_forward(nfft);
        Self::new(fft)
    }
    /// Create new fft engine from given fft engine
    pub fn new(fft: Arc<dyn RealToComplex<Flt>>) -> FFT {
        let nfft = fft.len();
        let timescratch = vec![0.; nfft];
        FFT {
            fft,
            timescratch,
            half_nfft_rounded: nfft / 2,
            nfftF: nfft as Flt,
        }
    }
    pub fn process<'a, T, U>(&mut self, time: T, freq: U)
    where
        T: Into<ArrayView<'a, Flt, Ix1>>,
        U: Into<ArrayViewMut<'a, Cflt, Ix1>>,
    {
        let mut freq = freq.into();
        let time = time.into();
        self.timescratch.copy_from_slice(time.as_slice().unwrap());
        let _ = self
            .fft
            .process(&mut self.timescratch, freq.as_slice_mut().unwrap());

        freq[0] /= self.nfftF;
        freq[self.half_nfft_rounded] /= self.nfftF;
        freq.slice_mut(s![1..self.half_nfft_rounded])
            .par_mapv_inplace(|x| 2. * x / self.nfftF);
    }
}