extendr_api::prelude::sparse::linalg::cholesky

Struct SymbolicCholesky

pub struct SymbolicCholesky<I>
where I: Index,
{ raw: SymbolicCholeskyRaw<I>, perm_fwd: Option<Vec<I>>, perm_inv: Option<Vec<I>>, A_nnz: usize, }
Expand description

The symbolic structure of a sparse Cholesky decomposition.

Fields§

§raw: SymbolicCholeskyRaw<I>§perm_fwd: Option<Vec<I>>§perm_inv: Option<Vec<I>>§A_nnz: usize

Implementations§

§

impl<I> SymbolicCholesky<I>
where I: Index,

pub fn nrows(&self) -> usize

Returns the number of rows of the matrix.

pub fn ncols(&self) -> usize

Returns the number of columns of the matrix.

pub fn raw(&self) -> &SymbolicCholeskyRaw<I>

Returns the inner type of the factorization, either simplicial or symbolic.

pub fn perm(&self) -> Option<PermRef<'_, I>>

Returns the permutation that was computed during symbolic analysis.

pub fn len_values(&self) -> usize

Returns the length of the slice needed to store the numerical values of the Cholesky decomposition.

pub fn factorize_numeric_llt_req<E>( &self, parallelism: Parallelism<'_>, ) -> Result<StackReq, SizeOverflow>
where E: Entity,

Computes the required workspace size and alignment for a numerical LLT factorization.

pub fn factorize_numeric_ldlt_req<E>( &self, with_regularization_signs: bool, parallelism: Parallelism<'_>, ) -> Result<StackReq, SizeOverflow>
where E: Entity,

Computes the required workspace size and alignment for a numerical LDLT factorization.

pub fn factorize_numeric_intranode_bunch_kaufman_req<E>( &self, with_regularization_signs: bool, parallelism: Parallelism<'_>, ) -> Result<StackReq, SizeOverflow>
where E: Entity,

Computes the required workspace size and alignment for a numerical intranodal Bunch-Kaufman factorization.

pub fn factorize_numeric_llt<'out, E>( &'out self, L_values: <<E as Entity>::Group as ForType>::FaerOf<&'out mut [<E as Entity>::Unit]>, A: SparseColMatRef<'_, I, E>, side: Side, regularization: LltRegularization<E>, parallelism: Parallelism<'_>, stack: PodStack<'_>, ) -> Result<LltRef<'out, I, E>, CholeskyError>
where E: ComplexField,

Computes a numerical LLT factorization of A, or returns a CholeskyError if the matrix is not numerically positive definite.

pub fn factorize_numeric_ldlt<'out, E>( &'out self, L_values: <<E as Entity>::Group as ForType>::FaerOf<&'out mut [<E as Entity>::Unit]>, A: SparseColMatRef<'_, I, E>, side: Side, regularization: LdltRegularization<'_, E>, parallelism: Parallelism<'_>, stack: PodStack<'_>, ) -> LdltRef<'out, I, E>
where E: ComplexField,

Computes a numerical LDLT factorization of A.

pub fn factorize_numeric_intranode_bunch_kaufman<'out, E>( &'out self, L_values: <<E as Entity>::Group as ForType>::FaerOf<&'out mut [<E as Entity>::Unit]>, subdiag: <<E as Entity>::Group as ForType>::FaerOf<&'out mut [<E as Entity>::Unit]>, perm_forward: &'out mut [I], perm_inverse: &'out mut [I], A: SparseColMatRef<'_, I, E>, side: Side, regularization: BunchKaufmanRegularization<'_, E>, parallelism: Parallelism<'_>, stack: PodStack<'_>, ) -> IntranodeBunchKaufmanRef<'out, I, E>
where E: ComplexField,

Computes a numerical intranodal Bunch-Kaufman factorization of A.

pub fn solve_in_place_req<E>( &self, rhs_ncols: usize, ) -> Result<StackReq, SizeOverflow>
where E: Entity,

Computes the required workspace size and alignment for a dense solve in place using an LLT, LDLT or intranodal Bunch-Kaufman factorization.

Trait Implementations§

§

impl<I> Debug for SymbolicCholesky<I>
where I: Debug + Index,

§

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

Formats the value using the given formatter. Read more

Auto Trait Implementations§

§

impl<I> Freeze for SymbolicCholesky<I>

§

impl<I> RefUnwindSafe for SymbolicCholesky<I>
where I: RefUnwindSafe,

§

impl<I> Send for SymbolicCholesky<I>

§

impl<I> Sync for SymbolicCholesky<I>

§

impl<I> Unpin for SymbolicCholesky<I>
where I: Unpin,

§

impl<I> UnwindSafe for SymbolicCholesky<I>
where I: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.