org.ojalgo.matrix.decomposition

Class LUDecomposition<N extends java.lang.Number>

java.lang.Object

org.ojalgo.matrix.decomposition.LUDecomposition<N>

All Implemented Interfaces:

LDU<N>, LU<N>, MatrixDecomposition<N>, DeterminantTask<N>, InverterTask<N>, MatrixTask<N>, SolverTask<N>

Deprecated.

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

@Deprecated
public abstract class LUDecomposition<N extends java.lang.Number>
extends java.lang.Object
implements LU<N>

Author:

apete

Nested Class Summary

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

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

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

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

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.InverterTask

BIG, COMPLEX, PRIMITIVE

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

BIG, COMPLEX, PRIMITIVE

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

BIG, COMPLEX, PRIMITIVE

Method Summary

Modifier and Type	Method and Description
boolean	compute(Access2D<?> aStore) Deprecated.
boolean	computeWithoutPivoting(MatrixStore<?> matrix) Deprecated. The normal MatrixDecomposition.compute(Access2D) method must handle cases where pivoting is required.
boolean	equals(MatrixStore<N> aStore, NumberContext context) Deprecated.
boolean	equals(java.lang.Object someObj)
N	getDeterminant() Deprecated.
MatrixStore<N>	getInverse() The output must be a "right inverse" and a "generalised inverse".
MatrixStore<N>	getInverse(DecompositionStore<N> preallocated) Deprecated. Implementiong this method is optional.
MatrixStore<N>	getL() Deprecated.
int[]	getPivotOrder() Deprecated. This can be used to create a [P] matrix using IdentityStore in combination with RowsStore or ColumnsStore.
int	getRank() Deprecated.
int[]	getReducedPivots() Deprecated.
MatrixStore<N>	getU() Deprecated. http://en.wikipedia.org/wiki/Row_echelon_form This is the same as [D][U].
MatrixStore<N>	invert(MatrixStore<N> original) The output must be a "right inverse" and a "generalised inverse".
MatrixStore<N>	invert(MatrixStore<N> original, DecompositionStore<N> preallocated) Implementiong this method is optional.
boolean	isComputed()
boolean	isFullSize() Deprecated.
boolean	isSolvable() Deprecated.
boolean	isSquareAndNotSingular() Deprecated.
static <N extends java.lang.Number> LU<N>	make(Access2D<N> aTypical) Deprecated. v38 Use LU.make(Access2D) instead
static LU<java.math.BigDecimal>	makeBig() Deprecated. v38 Use LU.makeBig() instead
static LU<ComplexNumber>	makeComplex() Deprecated. v38 Use LU.makeComplex() instead
static LU<java.lang.Double>	makeJama() Deprecated. v38 Use LU.makePrimitive() instead
static LU<java.lang.Double>	makePrimitive() Deprecated. v38 Use LU.makePrimitive() instead
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() Deprecated. Delete computed results, and resets attributes to default values
MatrixStore<N>	solve(Access2D<N> rhs) [A][X]=[B] or [this][return]=[rhs]
MatrixStore<N>	solve(Access2D<N> body, Access2D<N> rhs) [A][X]=[B] or [body][return]=[rhs]
MatrixStore<N>	solve(Access2D<N> body, Access2D<N> rhs, DecompositionStore<N> preallocated) Implementiong this method is optional.
MatrixStore<N>	solve(Access2D<N> rhs, DecompositionStore<N> preallocated) Deprecated. Solves [this][X] = [rhs] by first solving

Methods inherited from class java.lang.Object

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

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

reconstruct

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

calculateDeterminant

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

equals, getInverse, isComputed, solve

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

invert, invert, preallocate

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

preallocate, solve, solve

Method Detail

make

@Deprecated
public static final <N extends java.lang.Number> LU<N> make(Access2D<N> aTypical)

Deprecated. v38 Use LU.make(Access2D) instead

Specified by:

make in interface LU<N extends java.lang.Number>

makeBig

@Deprecated
public static final LU<java.math.BigDecimal> makeBig()

Deprecated. v38 Use LU.makeBig() instead

Specified by:

makeBig in interface LU<N extends java.lang.Number>

makeComplex

@Deprecated
public static final LU<ComplexNumber> makeComplex()

Deprecated. v38 Use LU.makeComplex() instead

Specified by:

makeComplex in interface LU<N extends java.lang.Number>

makeJama

@Deprecated
public static final LU<java.lang.Double> makeJama()

Deprecated. v38 Use LU.makePrimitive() instead

makePrimitive

@Deprecated
public static final LU<java.lang.Double> makePrimitive()

Deprecated. v38 Use LU.makePrimitive() instead

Specified by:

makePrimitive in interface LU<N extends java.lang.Number>

compute

public boolean compute(Access2D<?> aStore)

Deprecated.

Specified by:

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

Parameters:

aStore - A matrix to decompose

Returns:

true if the computation suceeded; false if not

computeWithoutPivoting

public boolean computeWithoutPivoting(MatrixStore<?> matrix)

Deprecated.

Description copied from interface: LU

The normal MatrixDecomposition.compute(Access2D) method must handle cases where pivoting is required. If you know that pivoting is not needed you may call this method instead - it's faster.

Specified by:

computeWithoutPivoting in interface LU<N extends java.lang.Number>

equals

public boolean equals(MatrixStore<N> aStore,
                      NumberContext context)

Deprecated.

Specified by:

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

getDeterminant

public N getDeterminant()

Deprecated.

Specified by:

getDeterminant in interface LDU<N extends java.lang.Number>

getInverse

public MatrixStore<N> getInverse(DecompositionStore<N> 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<N extends java.lang.Number>

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

getL

public MatrixStore<N> getL()

Deprecated.

Specified by:

getL in interface LU<N extends java.lang.Number>

getPivotOrder

public int[] getPivotOrder()

Deprecated.

Description copied from interface: LU

This can be used to create a [P] matrix using IdentityStore in combination with RowsStore or ColumnsStore.

Specified by:

getPivotOrder in interface LU<N extends java.lang.Number>

getRank

public int getRank()

Deprecated.

Specified by:

getRank in interface LU<N extends java.lang.Number>

getReducedPivots

public int[] getReducedPivots()

Deprecated.

getU

public MatrixStore<N> getU()

Deprecated.

Description copied from interface: LU

http://en.wikipedia.org/wiki/Row_echelon_form

This is the same as [D][U]. Together with the pivotOrder and [L] this constitutes an alternative, more compact, way to express the decomposition.

Specified by:

getU in interface LU<N extends java.lang.Number>

See Also:

LU.getPivotOrder(), LU.getL()

isFullSize

public final boolean isFullSize()

Deprecated.

Specified by:

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

Returns:

True if the implementation generates a full sized decomposition.

isSolvable

public boolean isSolvable()

Deprecated.

Specified by:

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

Returns:

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

See Also:

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

isSquareAndNotSingular

public final boolean isSquareAndNotSingular()

Deprecated.

Specified by:

isSquareAndNotSingular in interface LU<N extends java.lang.Number>

reset

public void reset()

Deprecated.

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>

solve

public MatrixStore<N> solve(Access2D<N> rhs,
                            DecompositionStore<N> preallocated)

Deprecated.

Solves [this][X] = [rhs] by first solving

 [L][Y] = [rhs]
 

and then

 [U][X] = [Y]
 

Specified by:

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

Parameters:

rhs - The right hand side

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:

[X] The solution will be written to "preallocated" and then returned.

See Also:

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

getInverse

public final MatrixStore<N> getInverse()

Description copied from interface: MatrixDecomposition

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

See Also:

BasicMatrix.invert()

solve

public final MatrixStore<N> solve(Access2D<N> rhs)

Description copied from interface: MatrixDecomposition

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

equals

public boolean equals(java.lang.Object someObj)

Overrides:

equals in class java.lang.Object

invert

public final MatrixStore<N> invert(MatrixStore<N> 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<N> invert(MatrixStore<N> original,
                                   DecompositionStore<N> 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<N> solve(Access2D<N> body,
                                  Access2D<N> rhs)

Description copied from interface: SolverTask

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

solve

public final MatrixStore<N> solve(Access2D<N> body,
                                  Access2D<N> rhs,
                                  DecompositionStore<N> 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()