Struct QuantizedMatrixFreeOp 

pub struct QuantizedMatrixFreeOp<F>
where
    F: Float + NumAssign + Zero + Sum + One + ScalarOperand + Send + Sync + Debug + 'static,
{ /* private fields */ }

A matrix-free operator that represents a quantized matrix

Implementations

impl<F> QuantizedMatrixFreeOp<F>

where F: Float + NumAssign + Zero + Sum + One + ScalarOperand + Send + Sync + Debug + FromPrimitive + AsPrimitive<f32> + 'static, f32: AsPrimitive<F>,

pub fn new<O>( rows: usize, cols: usize, bits: u8, method: QuantizationMethod, op_fn: O, ) -> LinalgResult<Self>

where O: Fn(&ArrayView1<'_, F>) -> LinalgResult<Array1<F>> + Send + Sync + 'static,

Create a new quantized matrix-free operator from a function

This allows direct specification of how the operator acts on vectors without materializing the quantized matrix.

Arguments

• rows - Number of rows in the matrix
• cols - Number of columns in the matrix
• bits - Bit width for quantization
• method - Quantization method
• op_fn - Function that implements the matrix-vector product in the quantized domain

Returns

A new QuantizedMatrixFreeOp instance

pub fn frommatrix( matrix: &ArrayView2<'_, F>, bits: u8, method: QuantizationMethod, ) -> LinalgResult<Self>

Create a quantized matrix-free operator from an explicit matrix

This quantizes the matrix and creates a matrix-free operator that applies the quantized matrix without materializing it for each operation.

Arguments

• matrix - Matrix to quantize
• bits - Bit width for quantization
• method - Quantization method

Returns

A new QuantizedMatrixFreeOp instance

pub fn symmetric(self) -> Self

Mark the operator as symmetric

Returns

Self with the symmetric flag set to true

pub fn positive_definite(self) -> Self

Mark the operator as positive definite

Returns

Self with the positive_definite flag set to true

pub fn params(&self) -> &QuantizationParams

Get the quantization parameters

pub fn block_diagonal( blocks: Vec<ArrayView2<'_, F>>, bits: u8, method: QuantizationMethod, ) -> LinalgResult<Self>

Create a memory-efficient operator for block-diagonal matrices

This is particularly useful for large models with block structure, as it avoids materializing the full matrix.

Arguments

• blocks - A vector of smaller matrices to place on the diagonal
• bits - Bit width for quantization
• method - Quantization method

Returns

A new QuantizedMatrixFreeOp instance

pub fn sparse( rows: usize, cols: usize, indices: Vec<(usize, usize)>, values: &ArrayView1<'_, F>, bits: u8, method: QuantizationMethod, ) -> LinalgResult<Self>

Create a memory-efficient operator for structured sparse matrices

This is particularly useful for large sparse models, as it stores only the non-zero elements and their indices.

Arguments

• rows - Number of rows in the matrix
• cols - Number of columns in the matrix
• indices - Pairs of (row, column) indices for non-zero elements
• values - Values at the corresponding indices
• bits - Bit width for quantization
• method - Quantization method

Returns

A new QuantizedMatrixFreeOp instance

pub fn banded( n: usize, bands: Vec<(isize, ArrayView1<'_, F>)>, bits: u8, method: QuantizationMethod, ) -> LinalgResult<Self>

Create a memory-efficient operator for a banded matrix

This is particularly useful for banded matrices like tridiagonal or pentadiagonal matrices, as it stores only the bands.

Arguments

• n - Size of the square matrix
• bands - Vector of (offset, band_values) pairs, where offset is the diagonal offset (0 for main diagonal, 1 for first super-diagonal, -1 for first sub-diagonal)
• bits - Bit width for quantization
• method - Quantization method

Returns

A new QuantizedMatrixFreeOp instance

Trait Implementations

impl<F> Clone for QuantizedMatrixFreeOp<F>

where F: Float + NumAssign + Zero + Sum + One + ScalarOperand + Send + Sync + Debug + 'static,

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<F> MatrixFreeOp<F> for QuantizedMatrixFreeOp<F>

where F: Float + NumAssign + Zero + Sum + One + ScalarOperand + Send + Sync + Debug + 'static,

fn apply(&self, x: &ArrayView1<'_, F>) -> LinalgResult<Array1<F>>

Apply the linear operator to a vector

fn nrows(&self) -> usize

Get the number of rows in the linear operator

fn ncols(&self) -> usize

Get the number of columns in the linear operator

fn is_symmetric(&self) -> bool

Check if the linear operator is symmetric

fn is_positive_definite(&self) -> bool

Check if the linear operator is positive definite