org.ojalgo.matrix

Interface BasicMatrix

All Superinterfaces:

Access1D<Number>, Access1D.Aggregatable<Number>, Access1D.Elements, Access2D<Number>, Access2D.Aggregatable<Number>, Access2D.Elements, Group, Group.Additive<BasicMatrix>, NormedVectorSpace<BasicMatrix,Number>, NumberContext.Enforceable<BasicMatrix>, Operation, Operation.Addition<BasicMatrix>, Operation.Multiplication<BasicMatrix>, Operation.Subtraction<BasicMatrix>, ScalarOperation, ScalarOperation.Addition<BasicMatrix,Number>, ScalarOperation.Division<BasicMatrix,Number>, ScalarOperation.Multiplication<BasicMatrix,Number>, ScalarOperation.Subtraction<BasicMatrix,Number>, Structure1D, Structure2D, Structure2D.ReducibleTo1D<BasicMatrix>, VectorSpace<BasicMatrix,Number>

All Known Implementing Classes:

ComplexMatrix, PrimitiveMatrix, QuaternionMatrix, RationalMatrix

Deprecated.

v46.3 Use the specific implementations instead PrimitiveMatrix, ComplexMatrix or RationalMatrix.

@Deprecated
public interface BasicMatrix
extends NormedVectorSpace<BasicMatrix,Number>, Operation.Subtraction<BasicMatrix>, Operation.Multiplication<BasicMatrix>, ScalarOperation.Addition<BasicMatrix,Number>, ScalarOperation.Division<BasicMatrix,Number>, ScalarOperation.Subtraction<BasicMatrix,Number>, Access2D<Number>, Access2D.Elements, Access2D.Aggregatable<Number>, Structure2D.ReducibleTo1D<BasicMatrix>, NumberContext.Enforceable<BasicMatrix>

This interface declares a limited set of high level methods for linear algebra. If this is not enough for your use case, then look at the various interfaces/classes in the org.ojalgo.matrix.store and/or org.ojalgo.matrix.decomposition packages.

Author:

apete

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	BasicMatrix.LogicalBuilder<N extends Number,I extends BasicMatrix> Deprecated.
static interface	BasicMatrix.PhysicalBuilder<N extends Number,I extends BasicMatrix> Deprecated.

Nested classes/interfaces inherited from interface org.ojalgo.algebra.Group

Group.Additive<S>, Group.Multiplicative<S>

Nested classes/interfaces inherited from interface org.ojalgo.algebra.Operation

Operation.Addition<T>, Operation.Division<T>, Operation.Multiplication<T>, Operation.Subtraction<T>

Nested classes/interfaces inherited from interface org.ojalgo.algebra.ScalarOperation

ScalarOperation.Addition<T,N extends Number>, ScalarOperation.Division<T,N extends Number>, ScalarOperation.Multiplication<T,N extends Number>, ScalarOperation.Subtraction<T,N extends Number>

Nested classes/interfaces inherited from interface org.ojalgo.structure.Access2D

Access2D.Aggregatable<N extends Number>, Access2D.Collectable<N extends Number,R extends Mutate2D.Receiver<N>>, Access2D.Elements, Access2D.ElementView<N extends Number>, Access2D.IndexOf, Access2D.Sliceable<N extends Number>, Access2D.Visitable<N extends Number>

Nested classes/interfaces inherited from interface org.ojalgo.structure.Structure2D

Structure2D.IntRowColumn, Structure2D.Logical<S extends Structure2D,B extends Structure2D.Logical<S,?>>, Structure2D.LongRowColumn, Structure2D.ReducibleTo1D<R extends Structure1D>, Structure2D.RowColumnCallback, Structure2D.RowColumnKey<R,C>, Structure2D.RowColumnMapper<R,C>

Nested classes/interfaces inherited from interface org.ojalgo.structure.Structure1D

Structure1D.BasicMapper<T>, Structure1D.IndexCallback, Structure1D.IndexMapper<T>, Structure1D.IntIndex, Structure1D.LongIndex, Structure1D.LoopCallback

Method Summary

Modifier and Type	Method and Description
BasicMatrix	add(int row, int col, Access2D<?> addend) Deprecated. v46 Use logical() or copy() instead
static double	calculateFrobeniusNorm(BasicMatrix matrix) Deprecated. The Frobenius norm is the square root of the sum of the squares of each element, or the square root of the sum of the square of the singular values.
static double	calculateInfinityNorm(BasicMatrix matrix) Deprecated.
static double	calculateOneNorm(BasicMatrix matrix) Deprecated.
BasicMatrix.PhysicalBuilder<? extends Number,? extends BasicMatrix>	copy() Deprecated.
BasicMatrix	divideElements(Access2D<?> aMtrx) Deprecated. v46 Use logical() or copy() instead
boolean	equals(Access2D<?> another, NumberContext precision) Deprecated.
void	flushCache() Deprecated. BasicMatrix instances are intended to be immutable.
BasicMatrix	getColumnsRange(int first, int limit) Deprecated. v46 Use logical() or copy() instead
Scalar<?>	getCondition() Deprecated. Matrix condition (2-norm)
Scalar<?>	getDeterminant() Deprecated.
List<Eigenvalue.Eigenpair>	getEigenpairs() Deprecated.
int	getRank() Deprecated. The rank of a matrix is the (maximum) number of linearly independent rows or columns it contains.
BasicMatrix	getRowsRange(int first, int kimit) Deprecated. v46 Use logical() or copy() instead
List<? extends Number>	getSingularValues() Deprecated. v40 Use SingularValue
Scalar<?>	getTrace() Deprecated. The sum of the diagonal elements.
BasicMatrix	invert() Deprecated. About inverting matrices:
boolean	isFullRank() Deprecated.
boolean	isHermitian() Deprecated.
boolean	isSymmetric() Deprecated.
BasicMatrix.LogicalBuilder<? extends Number,? extends BasicMatrix>	logical() Deprecated.
BasicMatrix	mergeColumns(Access2D<?> belowRows) Deprecated. v46 Use logical() or copy() instead
BasicMatrix	mergeRows(Access2D<?> rightColumns) Deprecated. v46 Use logical() or copy() instead
BasicMatrix	modify(UnaryFunction<? extends Number> aFunc) Deprecated. v42 Use logical() or copy() instead
BasicMatrix	multiplyElements(Access2D<?> aMtrx) Deprecated. v46 Use logical() or copy() instead
default BasicMatrix	selectColumns(int... someCols) Deprecated. v46 Use logical() or copy() instead
default BasicMatrix	selectRows(int... someRows) Deprecated. v46 Use logical() or copy() instead
BasicMatrix	solve(Access2D<?> aRHS) Deprecated. This method solves a system of linear equations: [this][X]=[aRHS].
Scalar<?>	toScalar(long row, long col) Deprecated. Extracts one element of this matrix as a Scalar.
BasicMatrix	transpose() Deprecated. Transposes this matrix.

Methods inherited from interface org.ojalgo.algebra.NormedVectorSpace

isSmall, norm, signum

Methods inherited from interface org.ojalgo.algebra.VectorSpace

conjugate

Methods inherited from interface org.ojalgo.algebra.Group.Additive

negate

Methods inherited from interface org.ojalgo.algebra.Operation.Addition

add

Methods inherited from interface org.ojalgo.algebra.ScalarOperation.Multiplication

multiply, multiply

Methods inherited from interface org.ojalgo.algebra.Operation.Subtraction

subtract

Methods inherited from interface org.ojalgo.algebra.Operation.Multiplication

multiply

Methods inherited from interface org.ojalgo.algebra.ScalarOperation.Addition

add, add

Methods inherited from interface org.ojalgo.algebra.ScalarOperation.Division

divide, divide

Methods inherited from interface org.ojalgo.algebra.ScalarOperation.Subtraction

subtract, subtract

Methods inherited from interface org.ojalgo.structure.Access2D

asCollectable2D, asPrimitive2D, byteValue, byteValue, columns, doubleValue, doubleValue, elements, equals, floatValue, floatValue, get, get, intValue, intValue, longValue, longValue, newPrimitiveColumnCollectable, newPrimitiveRowCollectable, rows, shortValue, shortValue, toRawCopy2D, toString, wrap, wrap, wrapAccess2D, wrapAccess2D

Methods inherited from interface org.ojalgo.structure.Access1D

asCollectable1D, asPrimitive1D, axpy, dot, equals, hashCode, nonzeros, supplyTo, toRawCopy1D, wrap, wrap, wrap, wrapAccess1D, wrapAccess1D, wrapAccess1D

Methods inherited from interface org.ojalgo.structure.Access2D.Elements

isAbsolute, isAbsolute, isColumnSmall, isColumnSmall, isRowSmall, isRowSmall, isSmall, isSmall

Methods inherited from interface org.ojalgo.structure.Access1D.Elements

isAllSmall

Methods inherited from interface org.ojalgo.structure.Access2D.Aggregatable

aggregateColumn, aggregateColumn, aggregateDiagonal, aggregateDiagonal, aggregateRow, aggregateRow, reduceColumns, reduceRows

Methods inherited from interface org.ojalgo.structure.Access1D.Aggregatable

aggregateAll, aggregateRange

Methods inherited from interface org.ojalgo.structure.Structure2D.ReducibleTo1D

reduceColumns, reduceRows

Methods inherited from interface org.ojalgo.structure.Structure2D

column, column, column, column, column, count, count, countColumns, countRows, index, index, isEmpty, isFat, isScalar, isSquare, isTall, isVector, loopAll, loopColumn, loopColumn, loopDiagonal, loopMatching, loopRow, loopRow, mapperOf, row, row, row, row, row

Methods inherited from interface org.ojalgo.structure.Structure1D

loopAll, loopMatching, loopRange, mapper

Methods inherited from interface org.ojalgo.type.context.NumberContext.Enforceable

enforce

Method Detail

calculateFrobeniusNorm

static double calculateFrobeniusNorm(BasicMatrix matrix)

Deprecated.

The Frobenius norm is the square root of the sum of the squares of each element, or the square root of the sum of the square of the singular values.

Returns:

The matrix' Frobenius norm

calculateInfinityNorm

static double calculateInfinityNorm(BasicMatrix matrix)

Deprecated.

Returns:

The inf-norm or maximum row sum

calculateOneNorm

static double calculateOneNorm(BasicMatrix matrix)

Deprecated.

Returns:

The 1-norm or maximum column sum

add

@Deprecated
BasicMatrix add(int row,
                            int col,
                            Access2D<?> addend)

Deprecated. v46 Use logical() or copy() instead

Parameters:

row - The row index of where to superimpose the top left element of the addend

col - The column index of where to superimpose the top left element of the addend

addend - A matrix to superimpose

Returns:

A new matrix

copy

BasicMatrix.PhysicalBuilder<? extends Number,? extends BasicMatrix> copy()

Deprecated.

Returns:

A fully mutable matrix builder with the elements initially set to a copy of this matrix.

divideElements

@Deprecated
BasicMatrix divideElements(Access2D<?> aMtrx)

Deprecated. v46 Use logical() or copy() instead

Divides the elements of this with the elements of aMtrx. The matrices must have equal dimensions.

Parameters:

aMtrx - The denominator elements.

Returns:

A new matrix whos elements are the elements of this divided with the elements of aMtrx.

equals

boolean equals(Access2D<?> another,
               NumberContext precision)

Deprecated.

Returns:

true if the frobenius norm of the difference between [this] and [aStore] is zero within the limits of aCntxt.

flushCache

void flushCache()

Deprecated.

BasicMatrix instances are intended to be immutable. If they are it is possible to cache (partial) calculation results. Calling this method should flush any cached calculation results.

getColumnsRange

@Deprecated
BasicMatrix getColumnsRange(int first,
                                        int limit)

Deprecated. v46 Use logical() or copy() instead

Parameters:

first - The first column to include.

limit - The limit (exclusive) - the first column not to include.

Returns:

A new matrix with only the specified range of columns

getCondition

Scalar<?> getCondition()

Deprecated.

Matrix condition (2-norm)

Returns:

ratio of largest to smallest singular value.

getDeterminant

Scalar<?> getDeterminant()

Deprecated.

Returns:

The matrix' determinant.

getEigenpairs

List<Eigenvalue.Eigenpair> getEigenpairs()

Deprecated.

getRank

int getRank()

Deprecated.

The rank of a matrix is the (maximum) number of linearly independent rows or columns it contains. It is also equal to the number of nonzero singular values of the matrix.

Returns:

The matrix' rank.

See Also:

MatrixDecomposition.RankRevealing

getRowsRange

@Deprecated
BasicMatrix getRowsRange(int first,
                                     int kimit)

Deprecated. v46 Use logical() or copy() instead

Parameters:

first - The first row to include.

kimit - The limit (exclusive) - the first row not to include.

Returns:

A new matrix with only the specified range of rows

getSingularValues

@Deprecated
List<? extends Number> getSingularValues()

Deprecated. v40 Use SingularValue

getTrace

Scalar<?> getTrace()

Deprecated.

The sum of the diagonal elements.

Returns:

The matrix' trace.

invert

BasicMatrix invert()

Deprecated.

About inverting matrices:

• "right inverse": [this][right inverse]=[I]. You may calculate it using solve(Access2D).
• "left inverse": [left inverse][this]=[I]. You may calculate it using solve(Access2D) and transposing.
• "generalised inverse": [this][generalised inverse][this]=[this]. Note that if [this] is singular or non-square, then [generalised inverse] is not unique.
• "pseudoinverse": The generalised inverse (there are typically/possibly many) with the smallest frobenius norm is called the pseudoinverse. You may calculate it using the QR or SingularValue decompositions.
• "inverse":
  • If [left inverse]=[right inverse] then it is also [inverse].
  • If [this] is square and has full rank then the [generalised inverse] is unique, with the [pseudoinverse] given, and equal to [inverse].

Returns:

The "best possible" inverse....

isFullRank

boolean isFullRank()

Deprecated.

Returns:

true if getRank() == min(Structure2D.countRows(), Structure2D.countColumns())

See Also:

MatrixDecomposition.RankRevealing

isHermitian

boolean isHermitian()

Deprecated.

isSymmetric

boolean isSymmetric()

Deprecated.

logical

BasicMatrix.LogicalBuilder<? extends Number,? extends BasicMatrix> logical()

Deprecated.

mergeColumns

@Deprecated
BasicMatrix mergeColumns(Access2D<?> belowRows)

Deprecated. v46 Use logical() or copy() instead

[belowRows] is appended below [this]. The two matrices must have the same number of columns.

Parameters:

belowRows - The matrix to merge.

Returns:

A new matrix with more rows.

mergeRows

@Deprecated
BasicMatrix mergeRows(Access2D<?> rightColumns)

Deprecated. v46 Use logical() or copy() instead

[rightColumns] is appended to the right of [this]. The two matrices must have the same number of rows.

Parameters:

rightColumns - The matrix to merge.

Returns:

A new matrix with more columns.

modify

@Deprecated
BasicMatrix modify(UnaryFunction<? extends Number> aFunc)

Deprecated. v42 Use logical() or copy() instead

multiplyElements

@Deprecated
BasicMatrix multiplyElements(Access2D<?> aMtrx)

Deprecated. v46 Use logical() or copy() instead

Multiplies the elements of this matrix with the elements of aMtrx. The matrices must have equal dimensions.

Parameters:

aMtrx - The elements to multiply by.

Returns:

A new matrix whos elements are the elements of this multiplied with the elements of aMtrx.

selectColumns

@Deprecated
default BasicMatrix selectColumns(int... someCols)

Deprecated. v46 Use logical() or copy() instead

Parameters:

someCols - An ordered array of column indeces.

Returns:

A matrix with a subset of, reordered, columns.

selectRows

@Deprecated
default BasicMatrix selectRows(int... someRows)

Deprecated. v46 Use logical() or copy() instead

Parameters:

someRows - An ordered array of row indeces.

Returns:

A matrix with a subset of, reordered, rows.

solve

BasicMatrix solve(Access2D<?> aRHS)

Deprecated.

This method solves a system of linear equations: [this][X]=[aRHS]. A combination of columns in [this] should produce a column(s) in [aRHS]. It is ok for [aRHS] to have more than 1 column.

• If the problem is over-qualified an approximate solution is returned.
• If the problem is under-qualified one possible solution is returned.

Remember that: [X][this]=[aRHS] is equivalent to [this]^T[X]^T=[aRHS]^T

Parameters:

aRHS - The right hand side of the equation.

Returns:

The solution, [X].

toScalar

Scalar<?> toScalar(long row,
                   long col)

Deprecated.

Extracts one element of this matrix as a Scalar.

Parameters:

row - A row index.

col - A column index.

Returns:

One matrix element

transpose

BasicMatrix transpose()

Deprecated.

Transposes this matrix. For complex matrices conjugate() and transpose() are NOT EQUAL.

Returns:

A matrix that is the transpose of this matrix.

See Also:

VectorSpace.conjugate()