fountain_engine 1.0.2

Core algorithms for fountain code encoding and decoding
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

// Copyright (c) 2025 Shenghao Yang. All rights reserved.
// Licensed under AGPL-3.0 or commercial license. See LICENSE for details.

use super::{HDPC, LDPC};
use crate::types::{
    BackSubstitutionMethod, CodeParams, CodeType, DegreeSetFn, InactivationStrategy,
};

/// Trait for code configuration
pub trait CodeScheme {
    /// Get code parameters
    fn get_params(&self) -> CodeParams;

    /// Get code type (systematic or ordinary)
    fn code_type(&self) -> CodeType;

    /// Create degree set generator
    fn create_degree_set_fn(&self) -> DegreeSetFn;

    /// Create precode components
    #[allow(clippy::type_complexity)]
    fn create_precode(&self) -> (Option<Box<dyn HDPC>>, Option<Box<dyn LDPC>>);

    /// Maximum number of inactivations
    fn max_inactive_num(&self) -> usize{
        self.get_params().h + self.get_params().b 
    }

    /// Inactivation strategy
    fn inac_strategy(&self) -> InactivationStrategy {
        InactivationStrategy::ByIndex
    }

    /// Back substitution method
    fn back_substitution_method(&self) -> BackSubstitutionMethod {
        BackSubstitutionMethod::Direct
    }
}