Struct Ic0 

pub struct Ic0<I, T> { /* private fields */ }

Numeric IC(0) factor of a Hermitian positive-definite CSC matrix A.

Holds the L value buffer together with the symbolic structure and the dense workspace used during refactorisation. After construction the factor can be refactored against any matrix with the same lower-triangle pattern — Ic0::refactorize performs zero heap allocations.

Implementations

impl<I: Index, T: ComplexField> Ic0<I, T>

pub fn new_with_symbolic(symbolic: SymbolicIc0<I>) -> Self

Allocate the value buffer and dense workspace for a given symbolic factor.

The returned factor is not yet populated — call Ic0::refactorize to fill it with values from a matrix matching symbolic’s pattern.

pub fn try_new(a: SparseColMatRef<'_, I, T>) -> Result<Self, Ic0Error>

Build a fully populated IC(0) factor from a Hermitian PD CSC matrix A.

Only the lower triangle of A is consumed — values above the diagonal are silently ignored. Allocates internally for the symbolic structure, the L value buffer, and the dense workspace.

pub fn dim(&self) -> usize

Dimension n of the factored matrix.

pub fn symbolic(&self) -> &SymbolicIc0<I>

Borrow the symbolic factor.

pub fn refactorize( &mut self, a: SparseColMatRef<'_, I, T>, ) -> Result<(), Ic0Error>

Refactorise against a new matrix with the same sparsity pattern.

Performs zero heap allocations.

Errors

• Ic0Error::PatternMismatch if a’s shape or column lengths disagree with the symbolic structure, or if the diagonal entries land at unexpected positions.
• Ic0Error::NotPositiveDefinite if a non-positive pivot is encountered (indicating the matrix is not positive definite, or that the IC(0) algorithm has broken down on a non-H-matrix input).

pub fn l_view(&self) -> SparseColMatRef<'_, I, T>

Construct a SparseColMatRef view over the L factor (lower triangular, diagonal stored first in each column with the positive real pivot value).

Trait Implementations

impl<I, T> BiLinOp<T> for Ic0<I, T>

where I: Index, T: ComplexField + Debug + Sync,

fn transpose_apply_scratch(&self, _rhs_ncols: usize, _par: Par) -> StackReq

computes the workspace layout required to apply the transpose or adjoint o self to a matrix with rhs_ncols columns

fn transpose_apply( &self, out: MatMut<'_, T>, rhs: MatRef<'_, T>, par: Par, _stack: &mut MemStack, )

applies the transpose of self to rhs, and stores the result in out

fn adjoint_apply( &self, out: MatMut<'_, T>, rhs: MatRef<'_, T>, par: Par, _stack: &mut MemStack, )

applies the adjoint of self to rhs, and stores the result in out

impl<I, T> BiPrecond<T> for Ic0<I, T>

where I: Index, T: ComplexField + Debug + Sync,

fn transpose_apply_in_place_scratch( &self, _rhs_ncols: usize, _par: Par, ) -> StackReq

computes the workspace layout required to apply the transpose or adjoint of self to a matrix with rhs_ncols columns in place

fn transpose_apply_in_place( &self, rhs: MatMut<'_, T>, par: Par, _stack: &mut MemStack, )

applies the transpose of self to rhs, and stores the result in rhs

fn adjoint_apply_in_place( &self, rhs: MatMut<'_, T>, par: Par, _stack: &mut MemStack, )

applies the adjoint of self to rhs, and stores the result in rhs

impl<I: Clone, T: Clone> Clone for Ic0<I, T>

fn clone(&self) -> Ic0<I, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<I: Debug, T: Debug> Debug for Ic0<I, T>

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

Formats the value using the given formatter.

impl<I, T> LinOp<T> for Ic0<I, T>

where I: Index, T: ComplexField + Debug + Sync,

fn apply_scratch(&self, _rhs_ncols: usize, _par: Par) -> StackReq

computes the workspace layout required to apply self or the conjugate o self to a matrix with rhs_ncols columns

fn nrows(&self) -> usize

output dimension of the operator

fn ncols(&self) -> usize

input dimension of the operator

fn apply( &self, out: MatMut<'_, T>, rhs: MatRef<'_, T>, par: Par, _stack: &mut MemStack, )

applies self to rhs, and stores the result in out

fn conj_apply( &self, out: MatMut<'_, T>, rhs: MatRef<'_, T>, par: Par, _stack: &mut MemStack, )

applies the conjugate of self to rhs, and stores the result in out

impl<I, T> Precond<T> for Ic0<I, T>

where I: Index, T: ComplexField + Debug + Sync,

fn apply_in_place_scratch(&self, _rhs_ncols: usize, _par: Par) -> StackReq

computes the workspace layout required to apply self or the conjugate of self to a matrix with rhs_ncols columns in place

fn apply_in_place(&self, rhs: MatMut<'_, T>, par: Par, _stack: &mut MemStack)

applies self to rhs, and stores the result in rhs

fn conj_apply_in_place( &self, rhs: MatMut<'_, T>, par: Par, _stack: &mut MemStack, )

applies the conjugate of self to rhs, and stores the result in rhs