Struct RotationMatrix 

pub struct RotationMatrix { /* private fields */ }

Deterministically generated orthogonal matrix for vector preconditioning.

The inner storage is Arc<[f64]> so Clone is O(1) — callers can pass copies between tasks without reallocating the dim * dim buffer.

Implementations

impl RotationMatrix

pub fn from_config(config: &CodecConfig) -> Self

Build a rotation matrix for the given CodecConfig.

pub fn build(seed: u64, dimension: u32) -> Self

Build a rotation matrix for the (seed, dimension) pair.

Panics

Panics if dimension == 0. In the normal flow, dimensions reach this function only via a validated CodecConfig, so this cannot be triggered by safe public APIs of the crate.

pub fn matrix(&self) -> &[f64]

Borrow the row-major dim * dim matrix buffer.

pub const fn dimension(&self) -> u32

The row/column count of the square matrix.

pub const fn seed(&self) -> u64

The seed that generated this matrix.

pub fn apply_into( &self, input: &[f32], output: &mut [f32], ) -> Result<(), CodecError>

Rotate input into output: output = matrix @ input.

Errors

Returns CodecError::LengthMismatch if either slice length differs from Self::dimension.

pub fn apply_inverse_into( &self, input: &[f32], output: &mut [f32], ) -> Result<(), CodecError>

Apply the inverse rotation: output = matrix^T @ input.

Valid because the matrix is orthogonal.

Errors

Returns CodecError::LengthMismatch if either slice length differs from Self::dimension.

pub fn verify_orthogonality(&self, tol: f64) -> bool

Return true if matrix @ matrix^T equals the identity within tol on every entry.

This is O(n^3); reserve for tests and low-frequency sanity checks.

Trait Implementations

impl Clone for RotationMatrix

fn clone(&self) -> RotationMatrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RotationMatrix

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

Formats the value using the given formatter.