org.ojalgo.matrix.decomposition

Class RawCholesky

java.lang.Object

org.ojalgo.matrix.decomposition.RawCholesky

All Implemented Interfaces:

Cholesky<java.lang.Double>, HermitianDecomposition<java.lang.Double>, LDU<java.lang.Double>, MatrixDecomposition<java.lang.Double>, DeterminantTask<java.lang.Double>, InverterTask<java.lang.Double>, MatrixTask<java.lang.Double>, SolverTask<java.lang.Double>

Deprecated.

v38 This class will be made package private. Use the inteface instead.

@Deprecated
public final class RawCholesky
extends java.lang.Object
implements Cholesky<java.lang.Double>

This class adapts JAMA's CholeskyDecomposition to ojAlgo's Cholesky interface.

Author:

apete

Nested Class Summary

Nested classes/interfaces inherited from interface org.ojalgo.matrix.task.DeterminantTask

DeterminantTask.Factory<N extends java.lang.Number>

Field Summary

Fields inherited from interface org.ojalgo.matrix.task.DeterminantTask

BIG, COMPLEX, PRIMITIVE

Constructor Summary

Constructors

Constructor and Description
RawCholesky() Deprecated. Not recommended to use this constructor directly.

Method Summary

Modifier and Type	Method and Description
boolean	compute(Access2D<?> matrix) Deprecated.
boolean	compute(Access2D<?> matrix, boolean checkHermitian) Deprecated.
boolean	equals(MatrixStore<java.lang.Double> aStore, NumberContext context) Deprecated.
java.lang.Double	getDeterminant() Deprecated.
MatrixStore<java.lang.Double>	getInverse() Deprecated. The output must be a "right inverse" and a "generalised inverse".
MatrixStore<java.lang.Double>	getInverse(DecompositionStore<java.lang.Double> preallocated) Deprecated. Implementiong this method is optional.
MatrixStore<java.lang.Double>	getL() Deprecated. Must implement either Cholesky.getL() or Cholesky.getR().
MatrixStore<java.lang.Double>	invert(MatrixStore<java.lang.Double> original) The output must be a "right inverse" and a "generalised inverse".
MatrixStore<java.lang.Double>	invert(MatrixStore<java.lang.Double> original, DecompositionStore<java.lang.Double> preallocated) Implementiong this method is optional.
boolean	isComputed()
boolean	isFullSize() Deprecated.
boolean	isSolvable() Deprecated.
boolean	isSPD() Deprecated. To use the Cholesky decomposition rather than the LU decomposition the matrix must be symmetric and positive definite.
DecompositionStore<N>	preallocate(Access2D<N> template) Implementiong this method is optional.
DecompositionStore<N>	preallocate(Access2D<N> templateBody, Access2D<N> templateRHS) Implementiong this method is optional.
void	reset() Delete computed results, and resets attributes to default values
MatrixStore<java.lang.Double>	solve(Access2D<java.lang.Double> rhs) Deprecated. [A][X]=[B] or [this][return]=[rhs]
MatrixStore<java.lang.Double>	solve(Access2D<java.lang.Double> body, Access2D<java.lang.Double> rhs) [A][X]=[B] or [body][return]=[rhs]
MatrixStore<java.lang.Double>	solve(Access2D<java.lang.Double> body, Access2D<java.lang.Double> rhs, DecompositionStore<java.lang.Double> preallocated) Implementiong this method is optional.
MatrixStore<java.lang.Double>	solve(Access2D<java.lang.Double> rhs, DecompositionStore<java.lang.Double> preallocated) Deprecated. Makes no use of preallocated at all.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ojalgo.matrix.decomposition.Cholesky

getR, make, makeBig, makeComplex, makePrimitive, reconstruct

Methods inherited from interface org.ojalgo.matrix.decomposition.LDU

calculateDeterminant

Methods inherited from interface org.ojalgo.matrix.decomposition.HermitianDecomposition

checkAndCompute

Methods inherited from interface org.ojalgo.matrix.decomposition.MatrixDecomposition

equals, isComputed, reset

Methods inherited from interface org.ojalgo.matrix.task.InverterTask

invert, invert, preallocate

Methods inherited from interface org.ojalgo.matrix.task.SolverTask

preallocate, solve, solve

Constructor Detail

RawCholesky

public RawCholesky()

Deprecated.

Not recommended to use this constructor directly. Consider using the static factory method Cholesky.make(Access2D) instead.

Method Detail

compute

public boolean compute(Access2D<?> matrix)

Deprecated.

Specified by:

compute in interface MatrixDecomposition<java.lang.Double>

Parameters:

matrix - A matrix to decompose

Returns:

true if the computation suceeded; false if not

compute

public boolean compute(Access2D<?> matrix,
                       boolean checkHermitian)

Deprecated.

Specified by:

compute in interface Cholesky<java.lang.Double>

equals

public boolean equals(MatrixStore<java.lang.Double> aStore,
                      NumberContext context)

Deprecated.

Specified by:

equals in interface MatrixDecomposition<java.lang.Double>

getDeterminant

public java.lang.Double getDeterminant()

Deprecated.

Specified by:

getDeterminant in interface LDU<java.lang.Double>

getInverse

public final MatrixStore<java.lang.Double> getInverse()

Deprecated.

Description copied from interface: MatrixDecomposition

The output must be a "right inverse" and a "generalised inverse".

Specified by:

getInverse in interface MatrixDecomposition<java.lang.Double>

See Also:

BasicMatrix.invert()

getL

public MatrixStore<java.lang.Double> getL()

Deprecated.

Description copied from interface: Cholesky

Must implement either Cholesky.getL() or Cholesky.getR().

Specified by:

getL in interface Cholesky<java.lang.Double>

isFullSize

public boolean isFullSize()

Deprecated.

Specified by:

isFullSize in interface MatrixDecomposition<java.lang.Double>

Returns:

True if the implementation generates a full sized decomposition.

isSolvable

public boolean isSolvable()

Deprecated.

Specified by:

isSolvable in interface MatrixDecomposition<java.lang.Double>

Returns:

true if it is ok to call MatrixDecomposition.solve(Access2D) (computation was successful); false if not

See Also:

MatrixDecomposition.solve(Access2D), MatrixDecomposition.isComputed()

solve

public MatrixStore<java.lang.Double> solve(Access2D<java.lang.Double> rhs)

Deprecated.

Description copied from interface: MatrixDecomposition

[A][X]=[B] or [this][return]=[rhs]

Specified by:

solve in interface MatrixDecomposition<java.lang.Double>

solve

public final MatrixStore<java.lang.Double> solve(Access2D<java.lang.Double> rhs,
                                                 DecompositionStore<java.lang.Double> preallocated)

Deprecated.

Makes no use of preallocated at all. Simply delegates to MatrixDecomposition.solve(Access2D).

Specified by:

solve in interface MatrixDecomposition<java.lang.Double>

Parameters:

rhs - The Right Hand Side, wont be modfied

preallocated - Preallocated memory for the results, possibly some intermediate results. You must assume this is modified, but you cannot assume it will contain the full/final/correct solution.

Returns:

The solution

See Also:

MatrixDecomposition.solve(Access2D, org.ojalgo.matrix.decomposition.DecompositionStore)

isSPD

public boolean isSPD()

Deprecated.

Description copied from interface: Cholesky

To use the Cholesky decomposition rather than the LU decomposition the matrix must be symmetric and positive definite. It is recommended that the decomposition algorithm checks for this during calculation. Possibly the matrix could be assumed to be symmetric (to improve performance) but tests should be made to assure the matrix is positive definite.

Specified by:

isSPD in interface Cholesky<java.lang.Double>

Returns:

true if the tests did not fail.

getInverse

public final MatrixStore<java.lang.Double> getInverse(DecompositionStore<java.lang.Double> preallocated)

Deprecated.

Description copied from interface: MatrixDecomposition

Implementiong this method is optional.

Exactly how a specific implementation makes use of preallocated is not specified by this interface. It must be documented for each implementation.

Should produce the same results as calling MatrixDecomposition.getInverse().

Specified by:

getInverse in interface MatrixDecomposition<java.lang.Double>

Parameters:

preallocated - Preallocated memory for the results, possibly some intermediate results. You must assume this is modified, but you cannot assume it will contain the full/final/correct solution.

Returns:

The inverse, this is where you get the solution

invert

public final MatrixStore<java.lang.Double> invert(MatrixStore<java.lang.Double> original)

Description copied from interface: InverterTask

The output must be a "right inverse" and a "generalised inverse".

See Also:

BasicMatrix.invert()

invert

public final MatrixStore<java.lang.Double> invert(MatrixStore<java.lang.Double> original,
                                                  DecompositionStore<java.lang.Double> preallocated)

Description copied from interface: InverterTask

Implementiong this method is optional.

Exactly how a specific implementation makes use of preallocated is not specified by this interface. It must be documented for each implementation.

Should produce the same results as calling InverterTask.invert(MatrixStore).

preallocated - Preallocated memory for the results, possibly some intermediate results. You must assume this is modified, but you cannot assume it will contain the full/final/correct solution.

Returns:

The inverse

solve

public final MatrixStore<java.lang.Double> solve(Access2D<java.lang.Double> body,
                                                 Access2D<java.lang.Double> rhs)

Description copied from interface: SolverTask

[A][X]=[B] or [body][return]=[rhs]

solve

public final MatrixStore<java.lang.Double> solve(Access2D<java.lang.Double> body,
                                                 Access2D<java.lang.Double> rhs,
                                                 DecompositionStore<java.lang.Double> preallocated)

Description copied from interface: SolverTask

Implementiong this method is optional.

Exactly how a specific implementation makes use of preallocated is not specified by this interface. It must be documented for each implementation.

Should produce the same results as calling SolverTask.solve(Access2D, Access2D).

rhs - The Right Hand Side, wont be modfied

preallocated - Preallocated memory for the results, possibly some intermediate results. You must assume this is modified, but you cannot assume it will contain the full/final/correct solution.

Returns:

The solution

preallocate

public final DecompositionStore<N> preallocate(Access2D<N> template)

Description copied from interface: InverterTask

Implementiong this method is optional.

Will create a DecompositionStore instance suitable for use with InverterTask.invert(MatrixStore, DecompositionStore). When solving an equation system [A][X]=[B] ([mxn][nxb]=[mxb]) the preallocated memory/matrix will typically be either mxb or nxb (if A is square then there is no doubt).

Specified by:

preallocate in interface InverterTask<N extends java.lang.Number>

preallocate

public final DecompositionStore<N> preallocate(Access2D<N> templateBody,
                                               Access2D<N> templateRHS)

Description copied from interface: SolverTask

Implementiong this method is optional.

Will create a DecompositionStore instance suitable for use with SolverTask.solve(Access2D, Access2D, DecompositionStore). When solving an equation system [A][X]=[B] ([mxn][nxb]=[mxb]) the preallocated memory/matrix will typically be either mxb or nxb (if A is square then there is no doubt).

Specified by:

preallocate in interface SolverTask<N extends java.lang.Number>

Returns:

isComputed

public final boolean isComputed()

Specified by:

isComputed in interface MatrixDecomposition<N extends java.lang.Number>

Returns:

true if computation has been attemped; false if not.

See Also:

MatrixDecomposition.compute(Access2D), MatrixDecomposition.isSolvable()

reset

public void reset()

Description copied from interface: MatrixDecomposition

Delete computed results, and resets attributes to default values

Specified by:

reset in interface MatrixDecomposition<N extends java.lang.Number>