NumericAL
A header-only C++20 lexer built on REAL
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Static Private Member Functions | List of all members
numerical::detail::definite_pencil< T > Struct Template Reference

The pencil A − λ B of a Hermitian A and a Hermitian positive-definite B (each read in its lower triangle, of the diagonal its real part) in standard form: B = L Lᴴ and C = L⁻¹ A L⁻ᴴ, Hermitian, as LAPACK's sygst (type 1) forms it from pencil_reduction_least, by two triangular solves below (pencil_standard_form). C's eigenpairs (λ, y) are the pencil's (λ, L⁻ᴴ y), those vectors B-orthonormal (Xᴴ B X = I), as scipy.linalg.eigh(a, b)'s. More...

#include <factorizations.hpp>

Public Member Functions

 definite_pencil (const matrix< T > &a, const matrix< T > &b)
 
matrix< T > vectors_of (matrix< T > &&v) const
 The pencil's eigenvectors from v, columns of C's (all or some): L⁻ᴴ V.
 

Public Attributes

matrix< T > factor
 L, lower-triangular, B = L Lᴴ.
 
matrix< T > reduced
 C = L⁻¹ A L⁻ᴴ, whole.
 

Static Private Member Functions

static matrix< T > checked_factor (const matrix< T > &a, const matrix< T > &b)
 
static matrix< T > standard_form (const matrix< T > &a, const matrix< T > &l)
 

Detailed Description

template<typename T>
struct numerical::detail::definite_pencil< T >

The pencil A − λ B of a Hermitian A and a Hermitian positive-definite B (each read in its lower triangle, of the diagonal its real part) in standard form: B = L Lᴴ and C = L⁻¹ A L⁻ᴴ, Hermitian, as LAPACK's sygst (type 1) forms it from pencil_reduction_least, by two triangular solves below (pencil_standard_form). C's eigenpairs (λ, y) are the pencil's (λ, L⁻ᴴ y), those vectors B-orthonormal (Xᴴ B X = I), as scipy.linalg.eigh(a, b)'s.

Definition at line 6600 of file factorizations.hpp.

Constructor & Destructor Documentation

◆ definite_pencil()

template<typename T >
numerical::detail::definite_pencil< T >::definite_pencil ( const matrix< T > &  a,
const matrix< T > &  b 
)
inline
Exceptions
dimension_errorIf a or b is not square, or their orders differ.
non_finite_errorIf an entry read is infinite or NaN.
not_positive_definite_errorIf b is not positive definite.

Definition at line 6607 of file factorizations.hpp.

Member Function Documentation

◆ checked_factor()

template<typename T >
static matrix< T > numerical::detail::definite_pencil< T >::checked_factor ( const matrix< T > &  a,
const matrix< T > &  b 
)
inlinestaticprivate

Definition at line 6628 of file factorizations.hpp.

◆ standard_form()

template<typename T >
static matrix< T > numerical::detail::definite_pencil< T >::standard_form ( const matrix< T > &  a,
const matrix< T > &  l 
)
inlinestaticprivate

Definition at line 6638 of file factorizations.hpp.

◆ vectors_of()

template<typename T >
matrix< T > numerical::detail::definite_pencil< T >::vectors_of ( matrix< T > &&  v) const
inline

The pencil's eigenvectors from v, columns of C's (all or some): L⁻ᴴ V.

Definition at line 6614 of file factorizations.hpp.

Member Data Documentation

◆ factor

L, lower-triangular, B = L Lᴴ.

Definition at line 6623 of file factorizations.hpp.

◆ reduced

C = L⁻¹ A L⁻ᴴ, whole.

Definition at line 6624 of file factorizations.hpp.


The documentation for this struct was generated from the following file: