DenseMatrix (JScience v4.3 API)

Overview

Package

Class

Tree

Deprecated

Index

Help

JScience v4.3

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.jscience.mathematics.vector
Class DenseMatrix<F extends Field<F>>

java.lang.Object
  org.jscience.mathematics.vector.Matrix<F>
      org.jscience.mathematics.vector.DenseMatrix<F>

All Implemented Interfaces:: Immutable, Realtime, ValueType, GroupAdditive<Matrix<F>>, Ring<Matrix<F>>, Structure<Matrix<F>>, VectorSpace<Matrix<F>,F>

public final class DenseMatrix<F extends Field<F>>
extends Matrix<F>
extends Matrix<F>

This class represents a matrix made of dense vectors (as rows). To create a dense matrix made of column vectors the transpose() method can be used. For example:

        DenseVector<Rational> column0 = DenseVector.valueOf(...);
        DenseVector<Rational> column1 = DenseVector.valueOf(...);
        DenseMatrix<Rational> M = DenseMatrix.valueOf(column0, column1).transpose();

As for any concrete structure, this class is declared final (otherwise most operations would have to be overridden to return the appropriate type). Specialized dense matrix should sub-class Matrix directly. For example:

        // Extension through composition.
        final class TriangularMatrix <F extends Field<F>> extends Matrix<F> {
             private DenseMatrix<F> _value; // Possible implementation.
             ...
             public TriangularMatrix opposite() { // Returns the right type.
                 return TriangularMatrix.valueOf(_value.opposite());
             }
             ...
        }

Version:: 3.3, January 2, 2007
Author:: Jean-Marie Dautelle

Field Summary

Fields inherited from class org.jscience.mathematics.vector.Matrix
`XML`

Method Summary

DenseMatrix<F> adjoint()
Returns the adjoint of this matrix.

F cofactor(int i, int j)
Returns the cofactor of an element in this matrix.

DenseMatrix<F> copy()
Returns a copy of this matrix allocated by the calling thread (possibly on the stack).

F determinant()
Returns the determinant of this matrix.

F get(int i, int j)
Returns a single element from this matrix.

DenseVector<F> getColumn(int j)
Returns the column identified by the specified index in this matrix.

DenseVector<F> getDiagonal()
Returns the diagonal vector.

int getNumberOfColumns()
Returns the number of columns n for this matrix.

int getNumberOfRows()
Returns the number of rows m for this matrix.

DenseVector<F> getRow(int i)
Returns the row identified by the specified index in this matrix.

DenseMatrix<F> inverse()
Returns the inverse of this matrix (must be square).

DenseMatrix<F> minus(Matrix<F> that)
Returns the difference between this matrix and the one specified.

DenseMatrix<F> opposite()
Returns the negation of this matrix.

DenseMatrix<F> plus(Matrix<F> that)
Returns the sum of this matrix with the one specified.

Matrix<F> tensor(Matrix<F> that)
Returns the linear algebraic matrix tensor product of this matrix and another (Kronecker product).

DenseMatrix<F> times(F k)
Returns the product of this matrix by the specified factor.

DenseMatrix<F> times(Matrix<F> that)
Returns the product of this matrix with the one specified.

DenseVector<F> times(Vector<F> v)
Returns the product of this matrix by the specified vector.

DenseMatrix<F> transpose()
Returns the transpose of this matrix.

static



<F extends Field<F>> 


DenseMatrix<F>

valueOf(DenseVector<F>... rows)
Returns a dense matrix holding the specified row vectors (column vectors if transposed).

static



<F extends Field<F>> 


DenseMatrix<F>

valueOf(F[][] elements)
Returns a dense matrix from the specified 2-dimensional array.

static



<F extends Field<F>> 


DenseMatrix<F>

valueOf(java.util.List<DenseVector<F>> rows)
Returns a dense matrix holding the row vectors from the specified collection (column vectors if transposed).

static



<F extends Field<F>> 


DenseMatrix<F>

valueOf(Matrix<F> that)
Returns a dense matrix equivalent to the specified matrix.

Vector<F> vectorization()
Returns the vectorization of this matrix.

Methods inherited from class org.jscience.mathematics.vector.Matrix
`divide, equals, equals, hashCode, isSquare, pow, pseudoInverse, solve, solve, toString, toText, trace`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Method Detail

valueOf

public static <F extends Field<F>> DenseMatrix<F> valueOf(F[][] elements)

Returns a dense matrix from the specified 2-dimensional array. The first dimension being the row and the second being the column.

Parameters:: elements - this matrix elements.
Returns:: the matrix having the specified elements.
Throws:: DimensionException - if rows have different length.
See Also:: DenseMatrix

valueOf

public static <F extends Field<F>> DenseMatrix<F> valueOf(DenseVector<F>... rows)

Returns a dense matrix holding the specified row vectors (column vectors if transposed).

Parameters:: rows - the row vectors.
Returns:: the matrix having the specified rows.
Throws:: DimensionException - if the rows do not have the same dimension.

valueOf

public static <F extends Field<F>> DenseMatrix<F> valueOf(java.util.List<DenseVector<F>> rows)

Returns a dense matrix holding the row vectors from the specified collection (column vectors if transposed).

Parameters:: rows - the list of row vectors.
Returns:: the matrix having the specified rows.
Throws:: DimensionException - if the rows do not have the same dimension.

valueOf

public static <F extends Field<F>> DenseMatrix<F> valueOf(Matrix<F> that)

Returns a dense matrix equivalent to the specified matrix.

Parameters:: that - the matrix to convert.
Returns:: that or a dense matrix holding the same elements as the specified matrix.