Package org.hipparchus.linear
Class ComplexSchurTransformer
java.lang.Object
org.hipparchus.linear.ComplexSchurTransformer
Class transforming a general complex matrix to Schur form.
A m × m complex matrix A can be written as the product of three matrices: A = P × T × PH with P a unitary matrix and T an upper triangular matrix. Both P and T are m × m matrices.
Transformation to Schur form is often not a goal by itself, but it is an
intermediate step in more general decomposition algorithms like
eigen decomposition. This class is therefore
intended for expert use. As a consequence of this explicitly limited scope,
many methods directly returns references to internal arrays, not copies.
- See Also:
-
Constructor Summary
ConstructorsConstructorDescriptionComplexSchurTransformer(FieldMatrix<Complex> matrix) Build the transformation to Schur form of a general complex matrix.ComplexSchurTransformer(FieldMatrix<Complex> matrix, double epsilon) Build the transformation to Schur form of a general complex matrix. -
Method Summary
Modifier and TypeMethodDescriptionstatic Complex[]getEigenvalues(FieldMatrix<Complex> matrix) getP()Returns the unitary matrix P of the transform.getPT()Returns the conjugate transpose of the matrix P of the transform.getT()Returns the triangular Schur matrix T of the transform.
-
Constructor Details
-
ComplexSchurTransformer
Build the transformation to Schur form of a general complex matrix.- Parameters:
matrix- matrix to transform- Throws:
MathIllegalArgumentException- if the matrix is not square
-
ComplexSchurTransformer
Build the transformation to Schur form of a general complex matrix.- Parameters:
matrix- matrix to transformepsilon- convergence criteria- Throws:
MathIllegalArgumentException- if the matrix is not square
-
-
Method Details
-
getP
Returns the unitary matrix P of the transform.P is a unitary matrix, i.e. its inverse is also its conjugate transpose.
- Returns:
- the P matrix
-
getPT
Returns the conjugate transpose of the matrix P of the transform.P is a unitary matrix, i.e. its inverse is also its conjugate transpose.
- Returns:
- the conjugate transpose of the P matrix
-
getT
Returns the triangular Schur matrix T of the transform.- Returns:
- the T matrix
-
getEigenvalues
-