Class ComplexSchurTransformer

java.lang.Object
org.hipparchus.linear.ComplexSchurTransformer

public class ComplexSchurTransformer extends Object
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 Details

    • ComplexSchurTransformer

      public ComplexSchurTransformer(FieldMatrix<Complex> matrix)
      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

      public ComplexSchurTransformer(FieldMatrix<Complex> matrix, double epsilon)
      Build the transformation to Schur form of a general complex matrix.
      Parameters:
      matrix - matrix to transform
      epsilon - convergence criteria
      Throws:
      MathIllegalArgumentException - if the matrix is not square
  • Method Details

    • getP

      public FieldMatrix<Complex> 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

      public FieldMatrix<Complex> 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

      public FieldMatrix<Complex> getT()
      Returns the triangular Schur matrix T of the transform.
      Returns:
      the T matrix
    • getEigenvalues

      public static Complex[] getEigenvalues(FieldMatrix<Complex> matrix)