pub struct ReedSolomonCode<F> { /* private fields */ }Expand description
Reed–Solomon codes over binary fields.
The Reed–Solomon code admits an efficient encoding algorithm over binary fields due to LCH14. The additive NTT encoding algorithm encodes messages interpreted as the coefficients of a polynomial in a non-standard, novel polynomial basis and the codewords are the polynomial evaluations over a linear subspace of the field. See the [binius-math] crate for more details.
Implementations§
Source§impl<F> ReedSolomonCode<F>
impl<F> ReedSolomonCode<F>
pub fn subspace(&self) -> &BinarySubspace<F>
Source§impl<F> ReedSolomonCode<F>
impl<F> ReedSolomonCode<F>
pub fn log_inv_rate(&self) -> usize
Source§impl<F: BinaryField> ReedSolomonCode<F>
impl<F: BinaryField> ReedSolomonCode<F>
pub fn new(log_dimension: usize, log_inv_rate: usize) -> Result<Self, Error>
pub fn with_ntt_subspace( ntt: &impl AdditiveNTT<Field = F>, log_dimension: usize, log_inv_rate: usize, ) -> Result<Self, Error>
pub fn with_domain_context_subspace( domain_context: &impl DomainContext<Field = F>, log_dimension: usize, log_inv_rate: usize, ) -> Result<Self, Error>
pub fn with_subspace( subspace: BinarySubspace<F>, log_dimension: usize, log_inv_rate: usize, ) -> Result<Self, Error>
pub const fn log_dim(&self) -> usize
pub const fn log_len(&self) -> usize
Sourcepub fn encode_batch<P, NTT>(
&self,
ntt: &NTT,
data: FieldSlice<'_, P>,
log_batch_size: usize,
) -> Result<FieldBuffer<P>, Error>where
P: PackedField<Scalar = F>,
NTT: AdditiveNTT<Field = F> + Sync,
pub fn encode_batch<P, NTT>(
&self,
ntt: &NTT,
data: FieldSlice<'_, P>,
log_batch_size: usize,
) -> Result<FieldBuffer<P>, Error>where
P: PackedField<Scalar = F>,
NTT: AdditiveNTT<Field = F> + Sync,
Encodes a message with an interleaved Reed–Solomon code.
This function interprets the message as a batch of independent vectors and applies an interleaved Reed–Solomon.
§Preconditions
data.log_len()equallog_dim() + log_batch_size.
§Postconditions
- On success, all elements in the output buffer are initialized with the encoded codeword.
§Throws
Error::EncoderSubspaceMismatchif the NTT subspace doesn’t match the code’s subspace.Error::Mathif the output buffer has incorrect dimensions.
Trait Implementations§
Source§impl<F: Clone> Clone for ReedSolomonCode<F>
impl<F: Clone> Clone for ReedSolomonCode<F>
Source§fn clone(&self) -> ReedSolomonCode<F>
fn clone(&self) -> ReedSolomonCode<F>
Returns a duplicate of the value. Read more
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source. Read moreAuto Trait Implementations§
impl<F> Freeze for ReedSolomonCode<F>
impl<F> RefUnwindSafe for ReedSolomonCode<F>where
F: RefUnwindSafe,
impl<F> Send for ReedSolomonCode<F>where
F: Send,
impl<F> Sync for ReedSolomonCode<F>where
F: Sync,
impl<F> Unpin for ReedSolomonCode<F>where
F: Unpin,
impl<F> UnwindSafe for ReedSolomonCode<F>where
F: UnwindSafe,
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more