Struct SymCooMatrix 

pub struct SymCooMatrix<T>
where
    T: Float + Debug + Copy,
{
    pub data: Vec<T>,
    pub rows: Vec<usize>,
    pub cols: Vec<usize>,
    pub shape: (usize, usize),
}

Symmetric Coordinate (SymCOO) matrix

This format stores only the lower triangular part of a symmetric matrix to save memory. It’s particularly useful for construction of symmetric matrices and for conversion to other symmetric formats.

Note

All operations maintain symmetry implicitly.

Fields

data: Vec<T>

Non-zero values in the lower triangular part

rows: Vec<usize>

Row indices for each non-zero element

cols: Vec<usize>

Column indices for each non-zero element

shape: (usize, usize)

Matrix shape (rows, cols), always square

Implementations

impl<T> SymCooMatrix<T>

where T: Float + Debug + Copy,

pub fn new( data: Vec<T>, rows: Vec<usize>, cols: Vec<usize>, shape: (usize, usize), ) -> SparseResult<Self>

Create a new symmetric COO matrix from raw data

Arguments

• data - Non-zero values in the lower triangular part
• rows - Row indices
• cols - Column indices
• shape - Matrix shape (n, n)

Returns

A symmetric COO matrix

Errors

Returns an error if:

• The shape is not square
• The arrays have inconsistent lengths
• Any index is out of bounds
• Upper triangular elements are included

pub fn from_coo(matrix: &CooMatrix<T>) -> SparseResult<Self>

Convert a regular COO matrix to symmetric COO format

This will verify that the matrix is symmetric and extract the lower triangular part.

Arguments

• matrix - COO matrix to convert

Returns

A symmetric COO matrix

pub fn is_symmetric(matrix: &CooMatrix<T>) -> bool

Check if a COO matrix is symmetric

Arguments

• matrix - COO matrix to check

Returns

true if the matrix is symmetric, false otherwise

pub fn shape(&self) -> (usize, usize)

Get the shape of the matrix

Returns

A tuple (rows, cols)

pub fn nnz_stored(&self) -> usize

Get the number of stored non-zero elements

Returns

The number of non-zero elements in the lower triangular part

pub fn nnz(&self) -> usize

Get the total number of non-zero elements in the full matrix

Returns

The total number of non-zero elements in the full symmetric matrix

pub fn get(&self, row: usize, col: usize) -> T

Get a single element from the matrix

Arguments

• row - Row index
• col - Column index

Returns

The value at position (row, col)

pub fn to_coo(&self) -> SparseResult<CooMatrix<T>>

Convert to standard COO matrix (reconstructing full symmetric matrix)

Returns

A standard COO matrix with both upper and lower triangular parts

pub fn to_dense(&self) -> Vec<Vec<T>>

Convert to dense matrix

Returns

A dense matrix representation as a vector of vectors

Trait Implementations

impl<T> Clone for SymCooMatrix<T>

where T: Float + Debug + Copy + Clone,

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for SymCooMatrix<T>

where T: Float + Debug + Copy + Debug,

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

Formats the value using the given formatter.