futuresdr 0.0.39

An Experimental Async SDR Runtime for Heterogeneous Architectures.
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

use crate::prelude::*;

/// Apply a function to combine two streams into one.
///
/// # Inputs
///
/// `in0`: Input A
///
/// `in1`: Input B
///
/// # Outputs
///
/// `out`: Combined output
///
/// # Usage
/// ```
/// use futuresdr::blocks::Combine;
///
/// let adder = Combine::<_, _, _, _>::new(|a: &f32, b: &f32| {
///     a + b
/// });
/// ```
#[derive(Block)]
#[allow(clippy::type_complexity)]
pub struct Combine<
    F,
    A,
    B,
    C,
    INA = DefaultCpuReader<A>,
    INB = DefaultCpuReader<B>,
    OUT = DefaultCpuWriter<C>,
> where
    F: FnMut(&A, &B) -> C + Send + 'static,
    A: Send + 'static,
    B: Send + 'static,
    C: Send + 'static,
    INA: CpuBufferReader<Item = A>,
    INB: CpuBufferReader<Item = B>,
    OUT: CpuBufferWriter<Item = C>,
{
    #[input]
    in0: INA,
    #[input]
    in1: INB,
    #[output]
    output: OUT,
    f: F,
}

impl<F, A, B, C, INA, INB, OUT> Combine<F, A, B, C, INA, INB, OUT>
where
    F: FnMut(&A, &B) -> C + Send + 'static,
    A: Send + 'static,
    B: Send + 'static,
    C: Send + 'static,
    INA: CpuBufferReader<Item = A>,
    INB: CpuBufferReader<Item = B>,
    OUT: CpuBufferWriter<Item = C>,
{
    /// Create [`Combine`] block
    ///
    /// ## Parameter
    /// - `f`: Function `(&A, &B) -> C` used to combine samples
    pub fn new(f: F) -> Self {
        Self {
            in0: INA::default(),
            in1: INB::default(),
            output: OUT::default(),
            f,
        }
    }
}

#[doc(hidden)]
impl<F, A, B, C, INA, INB, OUT> Kernel for Combine<F, A, B, C, INA, INB, OUT>
where
    F: FnMut(&A, &B) -> C + Send + 'static,
    A: Send + 'static,
    B: Send + 'static,
    C: Send + 'static,
    INA: CpuBufferReader<Item = A>,
    INB: CpuBufferReader<Item = B>,
    OUT: CpuBufferWriter<Item = C>,
{
    async fn work(
        &mut self,
        io: &mut WorkIo,
        _mio: &mut MessageOutputs,
        _meta: &mut BlockMeta,
    ) -> Result<()> {
        let i0 = self.in0.slice();
        let i1 = self.in1.slice();
        let o0 = self.output.slice();
        let i0_len = i0.len();
        let i1_len = i1.len();

        let m = std::cmp::min(i0.len(), i1.len());
        let m = std::cmp::min(m, o0.len());

        if m > 0 {
            for ((x0, x1), y) in i0.iter().zip(i1.iter()).zip(o0.iter_mut()) {
                *y = (self.f)(x0, x1);
            }

            self.in0.consume(m);
            self.in1.consume(m);
            self.output.produce(m);
        }

        if self.in0.finished() && m == i0_len {
            io.finished = true;
        }

        if self.in1.finished() && m == i1_len {
            io.finished = true;
        }

        Ok(())
    }
}