Struct BitSelection 

pub struct BitSelection { /* private fields */ }

The bits of a word of full_len bits that a rate matching transmits: output bit $t$ carries bit positions()[t] of the word (a bit may be sent several times, or never).

Examples

use comnum_fec::puncture::BitSelection;
// a word of 4 bits, bit 3 dropped, bit 0 repeated
let sel = BitSelection::new(vec![0, 1, 2, 0], 4)?;
assert_eq!(sel.select(&[1u8, 0, 1, 1])?, [1, 0, 1, 1]);
let mut full = [0.0; 4];
sel.accumulate_into(&[2.0, -1.0, 0.5, 3.0], &mut full)?;
assert_eq!(full, [5.0, -1.0, 0.5, 0.0]);

Implementations

impl BitSelection

pub fn new(positions: Vec<usize>, full_len: usize) -> Result<BitSelection>

The selection of the bits positions of a word of full_len bits.

Errors

comnum_core::Error::Config for a position beyond the word.

pub fn len(&self) -> usize

The number of transmitted bits.

pub fn is_empty(&self) -> bool

Whether nothing is transmitted.

pub fn full_len(&self) -> usize

The length of the word.

pub fn positions(&self) -> &[usize]

The bit of the word carried by every transmitted bit.

pub fn select<T: Copy>(&self, word: &[T]) -> Result<Vec<T>>

The transmitted bits of a word.

Errors

comnum_core::Error::Shape if word does not have BitSelection::full_len values.

pub fn accumulate_into(&self, llr: &[f64], out: &mut [f64]) -> Result<()>

The LLRs of the bits of the word from the LLRs of the transmitted bits into out: the sum over the copies of every bit, zero for a bit never sent.

Errors

comnum_core::Error::Shape if llr does not have BitSelection::len values or out BitSelection::full_len.

pub fn word_llr(&self, llr: &[f64]) -> Result<Vec<f64>>

BitSelection::accumulate_into into a new vector.

Errors

As BitSelection::accumulate_into.

Trait Implementations

impl Clone for BitSelection

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BitSelection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for BitSelection

impl PartialEq for BitSelection

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for BitSelection