SymmetricIndefiniteDecomposition<T> Class

Represents the symmetric indefinite (Bunch-Kaufman) decomposition of a real symmetric or complex Hermitian matrix.

Definition

Namespace: Numerics.NET.LinearAlgebra
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 10.9.0
C#
public abstract class SymmetricIndefiniteDecomposition<T> : Decomposition<T>
Inheritance
Object  →  LinearOperator<T>  →  Decomposition<T>  →  SymmetricIndefiniteDecomposition<T>

Type Parameters

T

Remarks

The Bunch-Kaufman decomposition of a real symmetric matrix A rewrites the matrix in the form A= LDLT or A= UDUT, where L is a unit lower triangular matrix, U is an unit upper triangular matrix, and D is a block diagonal matrix made up of 1x1 and 2x2 blocks.

SymmetricIndefiniteDecomposition<T> can operate in two modes. In overwrite mode, the original matrix is overwritten with the result of the decomposition. In preserve mode, the original matrix is preserved, and a new matrix is created to hold the decomposition. You can set the mode through the Overwrite property.

SymmetricIndefiniteDecomposition<T> inherits from LinearOperator<T>. This means you can use it to solve systems of linear equations where the matrix of the system is symmetric or Hermitian and need not be positive definite. You can solve for a single right-hand side, or for multiple right-hand sides using the Solve(Vector<T>) method. You can also calculate the determinant the inverse, and an estimate for the condition number.

To solve a symmetric positive definite system of equations, you can use the CholeskyDecomposition<T> class instead.

Constructors

SymmetricIndefiniteDecomposition<T> Constructs a new SymmetricIndefiniteDecomposition<T> object.

Properties

BaseMatrix Gets the underlying matrix of the decomposition.
(Inherited from Decomposition<T>)
BlockDiagonalFactor Returns the block diagonal component of this SymmetricIndefiniteDecomposition<T>.
ColumnCount Gets the number of columns in the matrix.
(Inherited from LinearOperator<T>)
ColumnIndex Gets or sets the index of labels for the columns of the matrix.
(Inherited from LinearOperator<T>)
Done Gets or sets a value that indicates whether the decomposition has been performed.
(Inherited from Decomposition<T>)
ElementType Gets the element type of the matrix.
(Inherited from LinearOperator<T>)
Factors Gets the three factors in multiplication order: the first factor, the block diagonal factor, and the transpose or conjugate transpose of the first factor.
(Overrides Decomposition<T>.Factors)
FactorTriangle Gets whether the first factor comes from the upper or lower triangular component before pivot permutations.
LowerTriangularFactor Returns the lower component, including pivot permutations, of this SymmetricIndefiniteDecomposition<T>.
NegativeEigenvalueCountGets the number of negative eigenvalues of the computed pivot blocks.
Overwrite Gets or sets whether the BaseMatrix should be overwritten by its decomposition.
(Inherited from Decomposition<T>)
PositiveEigenvalueCountGets the number of positive eigenvalues of the computed pivot blocks.
RowCount Gets the number of rows in the matrix.
(Inherited from LinearOperator<T>)
RowIndex Gets or sets the index of labels for the rows of the matrix.
(Inherited from LinearOperator<T>)
TwoByTwoPivotCountGets the number of two-by-two pivot blocks.
UpperTriangularFactor Gets the upper component, including pivot permutations, of this SymmetricIndefiniteDecomposition<T>.
ZeroEigenvalueCountGets the number of exactly zero eigenvalues of the computed pivot blocks.

Methods

ComputeFactors Computes the factors of the decomposition explicitly.
Decompose Performs the actual decomposition.
(Inherited from Decomposition<T>)
EqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
EstimateConditionNumber Calculates an estimate for the condition number of a matrix.
(Inherited from LinearOperator<T>)
FinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object)
GetDeterminant Calculates the determinant of a matrix.
(Overrides LinearOperator<T>.GetDeterminant())
GetHashCodeServes as the default hash function.
(Inherited from Object)
GetInverse() Calculates the inverse matrix..
(Inherited from LinearOperator<T>)
GetInverse(Boolean) Calculates the inverse of the factorized matrix.
(Inherited from LinearOperator<T>)
GetTypeGets the Type of the current instance.
(Inherited from Object)
IsSingular Gets whether the BaseMatrix of this decomposition is singular.
(Inherited from Decomposition<T>)
LeastSquaresSolve(Matrix<T>) Solves the system of linear equations for the specified right-hand side matrix in the least squares sense.
(Inherited from LinearOperator<T>)
LeastSquaresSolve(Vector<T>) Solves the system of linear equations for the specified right-hand side vector.
(Inherited from LinearOperator<T>)
LeastSquaresSolve(DenseMatrix<T>, Boolean) Solves the system of linear equations for the specified right-hand side dense matrix in the least squares sense and optionally overwrites the right-hand side with the solution.
(Inherited from LinearOperator<T>)
LeastSquaresSolve(DenseVector<T>, Boolean) Solves the system of linear equations for the specified right-hand side dense vector in the least squares sense and optionally overwrites the right-hand side with the solution.
(Inherited from LinearOperator<T>)
LeastSquaresSolveInto(Matrix<T>, Matrix<T>) Solves a system of equations defined by the matrix and multiple right-hand sides in the least squares sense.
(Inherited from LinearOperator<T>)
LeastSquaresSolveInto(Vector<T>, Vector<T>) Solves a system of equations defined by the matrix and the specified right-hand side in the least squares sense.
(Inherited from Decomposition<T>)
MemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
Multiply(Matrix<T>)Applies the linear operator to a matrix.
(Inherited from LinearOperator<T>)
Multiply(Vector<T>)Applies the linear operator to a vector.
(Inherited from LinearOperator<T>)
MultiplyAndAddAsLeftFactorCore Multiplies the matrix with a vector, adds the scaled result to another scaled vector, and returns the result.
(Inherited from Decomposition<T>)
MultiplyAsLeftCore(TransposeOperation, Matrix<T>, Matrix<T>) Multiplies a matrix by the linear operator and returns the result.
(Inherited from Decomposition<T>)
MultiplyAsLeftCore(TransposeOperation, Vector<T>, Vector<T>) Multiplies a vector by the linear operator and returns the result.
(Inherited from Decomposition<T>)
MultiplyTranspose(Matrix<T>)Applies the transpose of the linear operator to a matrix.
(Inherited from LinearOperator<T>)
MultiplyTranspose(Vector<T>)Applies the (conjugate) transpose of the linear operator to a vector.
(Inherited from LinearOperator<T>)
Rank() Returns the numerical rank of a matrix.
(Inherited from LinearOperator<T>)
Rank(T)Estimates numerical rank by thresholding the pivot-block eigenvalues.
(Overrides LinearOperator<T>.Rank(T))
SetSingular Sets a flag that indicates the underlying matrix of this decomposition is singular.
(Inherited from Decomposition<T>)
Solve(Matrix<T>) Solves the system of linear equations for the specified right-hand side matrix.
(Inherited from LinearOperator<T>)
Solve(Vector<T>) Solves the system of linear equations for the specified right-hand side vector.
(Inherited from LinearOperator<T>)
Solve(DenseMatrix<T>, Boolean) Solves the system of linear equations for the specified right-hand side dense matrix and optionally overwrites the right-hand side with the solution.
(Inherited from LinearOperator<T>)
Solve(DenseVector<T>, Boolean) Solves the system of linear equations for the specified right-hand side dense vector and optionally overwrites the right-hand side with the solution.
(Inherited from LinearOperator<T>)
SolveInto(Matrix<T>, Matrix<T>) Solves a system of equations defined by the matrix and multiple right-hand sides.
(Inherited from LinearOperator<T>)
SolveInto(Vector<T>, Vector<T>) Solves a system of equations defined by the matrix and the specified right-hand side.
(Inherited from LinearOperator<T>)
SolveInto(TransposeOperation, Matrix<T>, Matrix<T>) Solves a system of equations defined by the matrix and multiple right-hand sides.
(Inherited from LinearOperator<T>)
SolveInto(TransposeOperation, Vector<T>, Vector<T>) Solves a system of equations defined by the matrix and the specified right-hand side.
(Inherited from LinearOperator<T>)
SolveTranspose(Matrix<T>) Solves the transposed system of linear equations for the specified right-hand side matrix.
(Inherited from LinearOperator<T>)
SolveTranspose(Vector<T>) Solves the system of linear equations for the specified right-hand side vector.
(Inherited from LinearOperator<T>)
SolveTranspose(DenseMatrix<T>, Boolean) Solves the transposed system of linear equations for the specified right-hand side dense matrix and optionally overwrites the right-hand side with the solution.
(Inherited from LinearOperator<T>)
SolveTranspose(DenseVector<T>, Boolean) Solves the transposed system of linear equations for the specified right-hand side dense vector and optionally overwrites the right-hand side with the solution.
(Inherited from LinearOperator<T>)
SolveTransposeInto(Matrix<T>, Matrix<T>) Solves a system of equations defined by the matrix and multiple right-hand sides.
(Inherited from LinearOperator<T>)
SolveTransposeInto(Vector<T>, Vector<T>) Solves a system of equations defined by the matrix and the specified right-hand side.
(Inherited from LinearOperator<T>)
ToStringReturns a string that represents the current object.
(Inherited from Object)
ValidateSolveInto(TransposeOperation, Matrix<T>, Matrix<T>) Validates arguments for a matrix right-hand-side solve.
(Inherited from LinearOperator<T>)
ValidateSolveInto(TransposeOperation, Vector<T>, Vector<T>) Validates arguments for a vector right-hand-side solve.
(Inherited from LinearOperator<T>)

See Also