orion-sdr 0.0.21

DSP/SDR block library targeting HF-to-UHF, satellites, and Python bindings. Roadmap inside.
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
81
82
83
84
85
86
87
88
89
90
91

use num_complex::Complex32 as C32;

#[derive(Debug, Clone, Copy, Default)]
pub struct WorkReport {
    pub in_read: usize,
    pub out_written: usize,
}

pub trait Block {
    type In;
    type Out;
    fn process(&mut self, input: &[Self::In], output: &mut [Self::Out]) -> WorkReport;

    /// Optional specialized path; default forwards to `process`.
    #[inline]
    fn process_into(&mut self, input: &[Self::In], output: &mut [Self::Out]) -> WorkReport {
        self.process(input, output)
    }
}

/// Audio (f32) -> IQ (C32)
pub struct AudioToIqChain<B: Block<In = f32, Out = C32>> {
    block: B,
    out: Vec<C32>,
}
impl<B: Block<In = f32, Out = C32>> AudioToIqChain<B> {
    pub fn new(block: B) -> Self {
        Self { block, out: Vec::new() }
    }
    /// Original convenience API (takes ownership of Vec)
    pub fn process(&mut self, input: Vec<f32>) -> Vec<C32> {
        self.process_ref(&input)
    }
    /// Borrowed input to avoid clone in hot paths.
    pub fn process_ref(&mut self, input: &[f32]) -> Vec<C32> {
        if self.out.len() < input.len() {
            self.out.resize(input.len(), C32::new(0.0, 0.0));
        }
        let n = input.len();
        let _wr = self.block.process_into(input, &mut self.out[..n]);
        self.out[..n].to_vec()
    }
    /// Fully preallocated path.
    pub fn process_into(&mut self, input: &[f32], output: &mut [C32]) -> WorkReport {
        self.block.process_into(input, output)
    }
}

/// IQ (C32) -> IQ (C32)
pub struct IqToIqChain<B: Block<In = C32, Out = C32>> {
    block: B,
    out: Vec<C32>,
}
impl<B: Block<In = C32, Out = C32>> IqToIqChain<B> {
    pub fn new(block: B) -> Self { Self { block, out: Vec::new() } }
    pub fn process(&mut self, input: Vec<C32>) -> Vec<C32> { self.process_ref(&input) }
    pub fn process_ref(&mut self, input: &[C32]) -> Vec<C32> {
        if self.out.len() < input.len() { self.out.resize(input.len(), C32::new(0.0, 0.0)); }
        let n = input.len();
        let _wr = self.block.process_into(input, &mut self.out[..n]);
        self.out[..n].to_vec()
    }
    pub fn process_into(&mut self, input: &[C32], output: &mut [C32]) -> WorkReport {
        self.block.process_into(input, output)
    }
}

/// IQ (C32) -> Audio (f32)
pub struct IqToAudioChain<B: Block<In = C32, Out = f32>> {
    block: B,
    out: Vec<f32>,
}
impl<B: Block<In = C32, Out = f32>> IqToAudioChain<B> {
    pub fn new(block: B) -> Self {
        Self { block, out: Vec::new() }
    }
    pub fn process(&mut self, input: Vec<C32>) -> Vec<f32> {
        self.process_ref(&input)
    }
    pub fn process_ref(&mut self, input: &[C32]) -> Vec<f32> {
        if self.out.len() < input.len() {
            self.out.resize(input.len(), 0.0);
        }
        let n = input.len();
        let _wr = self.block.process_into(input, &mut self.out[..n]);
        self.out[..n].to_vec()
    }
    pub fn process_into(&mut self, input: &[C32], output: &mut [f32]) -> WorkReport {
        self.block.process_into(input, output)
    }
}