org.ojalgo.matrix.decomposition

Class RawSingularValue

java.lang.Object

org.ojalgo.matrix.decomposition.RawSingularValue

All Implemented Interfaces:

MatrixDecomposition<java.lang.Double>, SingularValue<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 RawSingularValue
extends java.lang.Object
implements SingularValue<java.lang.Double>

This class adapts JAMA's SingularValueDecomposition to ojAlgo's SingularValue interface. speed: 52.641s

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>

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

Constructor Summary

Constructors

Constructor and Description
RawSingularValue() 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 singularValuesOnly, boolean fullSize) Deprecated.
boolean	equals(MatrixStore<java.lang.Double> aStore, NumberContext context) Deprecated.
double	getCondition() Deprecated. The condition number.
RawStore	getD() Deprecated.
double	getFrobeniusNorm() Deprecated. Sometimes also called the Schatten 2-norm or Hilbert-Schmidt norm.
RawStore	getInverse() Deprecated. The output must be a "right inverse" and a "generalised inverse".
MatrixStore<java.lang.Double>	getInverse(DecompositionStore<java.lang.Double> preallocated) Deprecated. Makes no use of preallocated at all.
double	getKyFanNorm(int k) Deprecated. Ky Fan k-norm.
double	getOperatorNorm() Deprecated.
RawStore	getQ1() Deprecated. If [A] is m-by-n and its rank is r, then: The first r columns of [Q1] span the column space, range or image of [A]. The last m-r columns of [Q1] span the left nullspace or cokernel of [A]. Calculating the QR decomposition of [A] is a faster alternative.
RawStore	getQ2() Deprecated. If [A] is m-by-n and its rank is r, then: The first r columns of [Q2] span the row space or coimage of [A]. The last n-r columns of [Q2] span the nullspace or kernel of [A]. Calculating the QR decomposition of [A]T is a faster alternative.
int	getRank() Deprecated. Effective numerical matrix rank.
Array1D<java.lang.Double>	getSingularValues() Deprecated.
double	getTraceNorm() Deprecated.
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	isOrdered() Deprecated.
boolean	isSolvable() Deprecated.
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
RawStore	solve(Access2D<java.lang.Double> rhs) Deprecated. Internally this implementation uses the pseudoinverse that is recreated with every call.
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) Makes no use of preallocated at all.
java.lang.String	toString() Deprecated.

Methods inherited from class java.lang.Object

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

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

make, makeBig, makeComplex, makePrimitive, reconstruct

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

equals, 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

Constructor Detail

RawSingularValue

public RawSingularValue()

Deprecated.

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

Method Detail

compute

public boolean compute(Access2D<?> matrix,
                       boolean singularValuesOnly,
                       boolean fullSize)

Deprecated.

Specified by:

compute in interface SingularValue<java.lang.Double>

Parameters:

matrix - A matrix to decompose

singularValuesOnly - No need to calculate eigenvectors

fullSize - TODO

Returns:

true/false if the computation succeeded or not

equals

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

Deprecated.

Specified by:

equals in interface MatrixDecomposition<java.lang.Double>

getCondition

public double getCondition()

Deprecated.

Description copied from interface: SingularValue

The condition number.

Specified by:

getCondition in interface SingularValue<java.lang.Double>

Returns:

The largest singular value divided by the smallest singular value.

getD

public RawStore getD()

Deprecated.

Specified by:

getD in interface SingularValue<java.lang.Double>

Returns:

The diagonal matrix of singular values.

getFrobeniusNorm

public double getFrobeniusNorm()

Deprecated.

Description copied from interface: SingularValue

Sometimes also called the Schatten 2-norm or Hilbert-Schmidt norm.

Specified by:

getFrobeniusNorm in interface SingularValue<java.lang.Double>

Returns:

The square root of the sum of squares of the singular values.

getInverse

public RawStore 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()

getKyFanNorm

public double getKyFanNorm(int k)

Deprecated.

Description copied from interface: SingularValue

Ky Fan k-norm.

The first Ky Fan k-norm is the operator norm (the largest singular value), and the last is called the trace norm (the sum of all singular values).

Specified by:

getKyFanNorm in interface SingularValue<java.lang.Double>

Parameters:

k - The number of singular values to add up.

Returns:

The sum of the k largest singular values.

getOperatorNorm

public double getOperatorNorm()

Deprecated.

Specified by:

getOperatorNorm in interface SingularValue<java.lang.Double>

Returns:

2-norm

getQ1

public RawStore getQ1()

Deprecated.

Description copied from interface: SingularValue

If [A] is m-by-n and its rank is r, then:

• The first r columns of [Q1] span the column space, range or image of [A].
• The last m-r columns of [Q1] span the left nullspace or cokernel of [A].

Calculating the QR decomposition of [A] is a faster alternative.

Specified by:

getQ1 in interface SingularValue<java.lang.Double>

getQ2

public RawStore getQ2()

Deprecated.

Description copied from interface: SingularValue

If [A] is m-by-n and its rank is r, then:

• The first r columns of [Q2] span the row space or coimage of [A].
• The last n-r columns of [Q2] span the nullspace or kernel of [A].

Calculating the QR decomposition of [A]^T is a faster alternative.

Specified by:

getQ2 in interface SingularValue<java.lang.Double>

getRank

public int getRank()

Deprecated.

Description copied from interface: SingularValue

Effective numerical matrix rank.

Specified by:

getRank in interface SingularValue<java.lang.Double>

Returns:

The number of nonnegligible singular values.

getSingularValues

public Array1D<java.lang.Double> getSingularValues()

Deprecated.

Specified by:

getSingularValues in interface SingularValue<java.lang.Double>

Returns:

The singular values ordered in descending order.

getTraceNorm

public double getTraceNorm()

Deprecated.

Specified by:

getTraceNorm in interface SingularValue<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.

isOrdered

public boolean isOrdered()

Deprecated.

Specified by:

isOrdered in interface SingularValue<java.lang.Double>

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()

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<java.lang.Double>

solve

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

Deprecated.

Internally this implementation uses the pseudoinverse that is recreated with every call.

Specified by:

solve in interface MatrixDecomposition<java.lang.Double>

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class java.lang.Object

compute

public final 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

getInverse

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

Deprecated.

Makes no use of preallocated at all. Simply delegates to 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

See Also:

MatrixDecomposition.getInverse(org.ojalgo.matrix.decomposition.DecompositionStore)

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

solve

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

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

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)

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()