Struct DiaMatrix 

pub struct DiaMatrix<T> {
    pub nrows: usize,
    pub ncols: usize,
    pub offsets: Vec<i64>,
    pub diags: Vec<Vec<T>>,
}

Diagonal storage format for banded / multi-diagonal sparse matrices.

Stores explicitly named diagonals. Diagonal offset = 0 is the main diagonal, offset > 0 is superdiagonal, offset < 0 is subdiagonal.

Layout

Each diagonal d with offset k has length min(nrows, ncols, nrows - max(0,-k), ncols - max(0,k)). They are stored as flat Vec<T> with the first valid element at position 0.

Fields

nrows: usize

Number of rows.

ncols: usize

Number of columns.

offsets: Vec<i64>

Diagonal offsets (may be negative).

diags: Vec<Vec<T>>

Diagonal data; diags[i] has length equal to the diagonal with offsets[i].

Implementations

impl<T> DiaMatrix<T>

where T: Clone + Copy + Zero + SparseElement + Debug,

pub fn new( nrows: usize, ncols: usize, offsets: Vec<i64>, diags: Vec<Vec<T>>, ) -> SparseResult<Self>

Create a DiaMatrix from explicit diagonals.

Arguments

• nrows - Number of rows.
• ncols - Number of columns.
• offsets - Diagonal offsets.
• diags - One Vec<T> per offset.

pub fn from_csr(csr: &CsrMatrix<T>) -> SparseResult<Self>

Construct from a CSR matrix by extracting its diagonals.

pub fn spmv(&self, x: &[T]) -> SparseResult<Vec<T>>

where T: Add<Output = T> + Mul<Output = T>,

SpMV: y = self * x.

pub fn to_csr(&self) -> SparseResult<CsrMatrix<T>>

Convert to CSR format.

pub fn nnz(&self) -> usize

Number of non-zeros (sum of diagonal lengths).

Trait Implementations

impl<T: Clone> Clone for DiaMatrix<T>

fn clone(&self) -> DiaMatrix<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for DiaMatrix<T>

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

Formats the value using the given formatter.