Package org.ejml.dense.row.decomposition.eig

Class WatchedDoubleStepQRDecomposition_FDRM

java.lang.Object

org.ejml.dense.row.decomposition.eig.WatchedDoubleStepQRDecomposition_FDRM

All Implemented Interfaces:

DecompositionInterface<FMatrixRMaj>, EigenDecomposition<FMatrixRMaj>, EigenDecomposition_F32<FMatrixRMaj>

@Generated("org.ejml.dense.row.decomposition.eig.WatchedDoubleStepQRDecomposition_DDRM")
public class WatchedDoubleStepQRDecomposition_FDRM
extends Object
implements EigenDecomposition_F32<FMatrixRMaj>

Finds the eigenvalue decomposition of an arbitrary square matrix using the implicit float-step QR algorithm. Watched is included in its name because it is designed to print out internal debugging information. This class is still underdevelopment and has yet to be optimized.

Based off the description found in:
David S. Watkins, "Fundamentals of Matrix Computations." Second Edition.

Constructor Summary

Constructors

Constructor	Description
WatchedDoubleStepQRDecomposition_FDRM(boolean computeVectors)
WatchedDoubleStepQRDecomposition_FDRM(HessenbergSimilarDecomposition_FDRM hessenberg, WatchedDoubleStepQREigen_FDRM eigenQR, boolean computeVectors)

Method Summary

Modifier and Type	Method	Description
boolean	decompose(FMatrixRMaj A)	Computes the decomposition of the input matrix.
Complex_F32	getEigenvalue(int index)	Returns an eigenvalue as a complex number.
FMatrixRMaj	getEigenVector(int index)	Used to retrieve real valued eigenvectors.
int	getNumberOfEigenvalues()	Returns the number of eigenvalues/eigenvectors.
boolean	inputModified()	Checks if the input matrix to DecompositionInterface.decompose(org.ejml.data.Matrix) is modified during the decomposition process.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

WatchedDoubleStepQRDecomposition_FDRM

public WatchedDoubleStepQRDecomposition_FDRM(boolean computeVectors)

WatchedDoubleStepQRDecomposition_FDRM

public WatchedDoubleStepQRDecomposition_FDRM(HessenbergSimilarDecomposition_FDRM hessenberg,
 WatchedDoubleStepQREigen_FDRM eigenQR,
 boolean computeVectors)

Method Details

decompose

public boolean decompose(FMatrixRMaj A)

Description copied from interface: DecompositionInterface

Computes the decomposition of the input matrix. Depending on the implementation the input matrix might be stored internally or modified. If it is modified then the function DecompositionInterface.inputModified() will return true and the matrix should not be modified until the decomposition is no longer needed.

Specified by:

decompose in interface DecompositionInterface<FMatrixRMaj>

Parameters:

A - The matrix which is being decomposed. Modification is implementation dependent.

Returns:

Returns if it was able to decompose the matrix.

inputModified

public boolean inputModified()

Description copied from interface: DecompositionInterface

Checks if the input matrix to DecompositionInterface.decompose(org.ejml.data.Matrix) is modified during the decomposition process.

Specified by:

inputModified in interface DecompositionInterface<FMatrixRMaj>

Returns:

true if the input matrix to decompose() is modified.

getNumberOfEigenvalues

public int getNumberOfEigenvalues()

Description copied from interface: EigenDecomposition

Returns the number of eigenvalues/eigenvectors. This is the matrix's dimension.

Specified by:

getNumberOfEigenvalues in interface EigenDecomposition<FMatrixRMaj>

Returns:

number of eigenvalues/eigenvectors.

getEigenvalue

public Complex_F32 getEigenvalue(int index)

Description copied from interface: EigenDecomposition_F32

Returns an eigenvalue as a complex number. For symmetric matrices the returned eigenvalue will always be a real number, which means the imaginary component will be equal to zero.

NOTE: The order of the eigenvalues is dependent upon the decomposition algorithm used. This means that they may or may not be ordered by magnitude. For example the QR algorithm will returns results that are partially ordered by magnitude, but this behavior should not be relied upon.

Specified by:

getEigenvalue in interface EigenDecomposition_F32<FMatrixRMaj>

Parameters:

index - Index of the eigenvalue eigenvector pair.

Returns:

An eigenvalue.

getEigenVector

public FMatrixRMaj getEigenVector(int index)

Description copied from interface: EigenDecomposition

Used to retrieve real valued eigenvectors. If an eigenvector is associated with a complex eigenvalue then null is returned instead.

Specified by:

getEigenVector in interface EigenDecomposition<FMatrixRMaj>

Parameters:

index - Index of the eigenvalue eigenvector pair.

Returns:

If the associated eigenvalue is real then an eigenvector is returned, null otherwise.