T
- Type of the field elements.public abstract class AbstractFieldMatrix<T extends FieldElement<T>> extends Object implements FieldMatrix<T>
FieldMatrix
methods regardless of the underlying storage.
All the methods implemented here use getEntry(int, int)
to access
matrix elements. Derived class can provide faster implementations.
Modifier | Constructor and Description |
---|---|
protected |
AbstractFieldMatrix()
Constructor for use with Serializable
|
protected |
AbstractFieldMatrix(Field<T> field)
Creates a matrix with no data
|
protected |
AbstractFieldMatrix(Field<T> field,
int rowDimension,
int columnDimension)
Create a new FieldMatrix
|
Modifier and Type | Method and Description |
---|---|
FieldMatrix<T> |
add(FieldMatrix<T> m)
Compute the sum of this and m.
|
abstract void |
addToEntry(int row,
int column,
T increment)
Change an entry in the specified row and column.
|
protected static <T extends FieldElement<T>> |
buildArray(Field<T> field,
int length)
Deprecated.
as of 3.2, replaced by
MathArrays.buildArray(Field, int) |
protected static <T extends FieldElement<T>> |
buildArray(Field<T> field,
int rows,
int columns)
Deprecated.
as of 3.2, replaced by
MathArrays.buildArray(Field, int, int) |
protected void |
checkAdditionCompatible(FieldMatrix<T> m)
Check if a matrix is addition compatible with the instance.
|
protected void |
checkColumnIndex(int column)
Check if a column index is valid.
|
protected void |
checkMultiplicationCompatible(FieldMatrix<T> m)
Check if a matrix is multiplication compatible with the instance.
|
protected void |
checkRowIndex(int row)
Check if a row index is valid.
|
protected void |
checkSubMatrixIndex(int[] selectedRows,
int[] selectedColumns)
Check if submatrix ranges indices are valid.
|
protected void |
checkSubMatrixIndex(int startRow,
int endRow,
int startColumn,
int endColumn)
Check if submatrix ranges indices are valid.
|
protected void |
checkSubtractionCompatible(FieldMatrix<T> m)
Check if a matrix is subtraction compatible with the instance.
|
abstract FieldMatrix<T> |
copy()
Make a (deep) copy of this.
|
void |
copySubMatrix(int[] selectedRows,
int[] selectedColumns,
T[][] destination)
Copy a submatrix.
|
void |
copySubMatrix(int startRow,
int endRow,
int startColumn,
int endColumn,
T[][] destination)
Copy a submatrix.
|
abstract FieldMatrix<T> |
createMatrix(int rowDimension,
int columnDimension)
Create a new FieldMatrix
|
boolean |
equals(Object object)
Returns true iff
object is a
FieldMatrix instance with the same dimensions as this
and all corresponding matrix entries are equal. |
protected static <T extends FieldElement<T>> |
extractField(T[] d)
Get the elements type from an array.
|
protected static <T extends FieldElement<T>> |
extractField(T[][] d)
Get the elements type from an array.
|
T[] |
getColumn(int column)
Get the entries in column number
col as an array. |
abstract int |
getColumnDimension()
Returns the number of columns in the matrix.
|
FieldMatrix<T> |
getColumnMatrix(int column)
Get the entries in column number
column
as a column matrix. |
FieldVector<T> |
getColumnVector(int column)
Returns the entries in column number
column
as a vector. |
T[][] |
getData()
Returns matrix entries as a two-dimensional array.
|
abstract T |
getEntry(int row,
int column)
Returns the entry in the specified row and column.
|
Field<T> |
getField()
Get the type of field elements of the matrix.
|
T[] |
getRow(int row)
Get the entries in row number
row as an array. |
abstract int |
getRowDimension()
Returns the number of rows in the matrix.
|
FieldMatrix<T> |
getRowMatrix(int row)
Get the entries in row number
row
as a row matrix. |
FieldVector<T> |
getRowVector(int row)
Get the entries in row number
row
as a vector. |
FieldMatrix<T> |
getSubMatrix(int[] selectedRows,
int[] selectedColumns)
Get a submatrix.
|
FieldMatrix<T> |
getSubMatrix(int startRow,
int endRow,
int startColumn,
int endColumn)
Get a submatrix.
|
T |
getTrace()
Returns the
trace of the matrix (the sum of the elements on the main diagonal).
|
int |
hashCode()
Computes a hashcode for the matrix.
|
boolean |
isSquare()
Is this a square matrix?
|
FieldMatrix<T> |
multiply(FieldMatrix<T> m)
Postmultiply this matrix by
m . |
abstract void |
multiplyEntry(int row,
int column,
T factor)
Change an entry in the specified row and column.
|
FieldVector<T> |
operate(FieldVector<T> v)
Returns the result of multiplying this by the vector
v . |
T[] |
operate(T[] v)
Returns the result of multiplying this by the vector
v . |
FieldMatrix<T> |
power(int p)
Returns the result multiplying this with itself
p times. |
FieldMatrix<T> |
preMultiply(FieldMatrix<T> m)
Premultiply this matrix by
m . |
FieldVector<T> |
preMultiply(FieldVector<T> v)
Returns the (row) vector result of premultiplying this by the vector
v . |
T[] |
preMultiply(T[] v)
Returns the (row) vector result of premultiplying this by the vector
v . |
FieldMatrix<T> |
scalarAdd(T d)
Increment each entry of this matrix.
|
FieldMatrix<T> |
scalarMultiply(T d)
Multiply each entry by
d . |
void |
setColumn(int column,
T[] array)
Set the entries in column number
column
as a column matrix. |
void |
setColumnMatrix(int column,
FieldMatrix<T> matrix)
Set the entries in column number
column
as a column matrix. |
void |
setColumnVector(int column,
FieldVector<T> vector)
Set the entries in column number
column
as a vector. |
abstract void |
setEntry(int row,
int column,
T value)
Set the entry in the specified row and column.
|
void |
setRow(int row,
T[] array)
Set the entries in row number
row
as a row matrix. |
void |
setRowMatrix(int row,
FieldMatrix<T> matrix)
Set the entries in row number
row
as a row matrix. |
void |
setRowVector(int row,
FieldVector<T> vector)
Set the entries in row number
row
as a vector. |
void |
setSubMatrix(T[][] subMatrix,
int row,
int column)
Replace the submatrix starting at
(row, column) using data in the
input subMatrix array. |
FieldMatrix<T> |
subtract(FieldMatrix<T> m)
Subtract
m from this matrix. |
String |
toString()
Get a string representation for this matrix.
|
FieldMatrix<T> |
transpose()
Returns the transpose of this matrix.
|
T |
walkInColumnOrder(FieldMatrixChangingVisitor<T> visitor)
Visit (and possibly change) all matrix entries in column order.
|
T |
walkInColumnOrder(FieldMatrixChangingVisitor<T> visitor,
int startRow,
int endRow,
int startColumn,
int endColumn)
Visit (and possibly change) some matrix entries in column order.
|
T |
walkInColumnOrder(FieldMatrixPreservingVisitor<T> visitor)
Visit (but don't change) all matrix entries in column order.
|
T |
walkInColumnOrder(FieldMatrixPreservingVisitor<T> visitor,
int startRow,
int endRow,
int startColumn,
int endColumn)
Visit (but don't change) some matrix entries in column order.
|
T |
walkInOptimizedOrder(FieldMatrixChangingVisitor<T> visitor)
Visit (and possibly change) all matrix entries using the fastest possible order.
|
T |
walkInOptimizedOrder(FieldMatrixChangingVisitor<T> visitor,
int startRow,
int endRow,
int startColumn,
int endColumn)
Visit (and possibly change) some matrix entries using the fastest possible order.
|
T |
walkInOptimizedOrder(FieldMatrixPreservingVisitor<T> visitor)
Visit (but don't change) all matrix entries using the fastest possible order.
|
T |
walkInOptimizedOrder(FieldMatrixPreservingVisitor<T> visitor,
int startRow,
int endRow,
int startColumn,
int endColumn)
Visit (but don't change) some matrix entries using the fastest possible order.
|
T |
walkInRowOrder(FieldMatrixChangingVisitor<T> visitor)
Visit (and possibly change) all matrix entries in row order.
|
T |
walkInRowOrder(FieldMatrixChangingVisitor<T> visitor,
int startRow,
int endRow,
int startColumn,
int endColumn)
Visit (and possibly change) some matrix entries in row order.
|
T |
walkInRowOrder(FieldMatrixPreservingVisitor<T> visitor)
Visit (but don't change) all matrix entries in row order.
|
T |
walkInRowOrder(FieldMatrixPreservingVisitor<T> visitor,
int startRow,
int endRow,
int startColumn,
int endColumn)
Visit (but don't change) some matrix entries in row order.
|
protected AbstractFieldMatrix()
protected AbstractFieldMatrix(Field<T> field)
field
- field to which the elements belongprotected AbstractFieldMatrix(Field<T> field, int rowDimension, int columnDimension) throws NotStrictlyPositiveException
field
- Field to which the elements belong.rowDimension
- Number of rows in the new matrix.columnDimension
- Number of columns in the new matrix.NotStrictlyPositiveException
- if row or column dimension is not
positive.protected static <T extends FieldElement<T>> Field<T> extractField(T[][] d) throws NoDataException, NullArgumentException
T
- Type of the field elements.d
- Data array.NullArgumentException
- if the array is null
.NoDataException
- if the array is empty.protected static <T extends FieldElement<T>> Field<T> extractField(T[] d) throws NoDataException
T
- Type of the field elements.d
- Data array.NoDataException
- if array is empty.@Deprecated protected static <T extends FieldElement<T>> T[][] buildArray(Field<T> field, int rows, int columns)
MathArrays.buildArray(Field, int, int)
Complete arrays are filled with field.getZero()
T
- Type of the field elementsfield
- field to which array elements belongrows
- number of rowscolumns
- number of columns (may be negative to build partial
arrays in the same way new Field[rows][]
works)@Deprecated protected static <T extends FieldElement<T>> T[] buildArray(Field<T> field, int length)
MathArrays.buildArray(Field, int)
Arrays are filled with field.getZero()
T
- the type of the field elementsfield
- field to which array elements belonglength
- of the arraypublic Field<T> getField()
getField
in interface FieldMatrix<T extends FieldElement<T>>
public abstract FieldMatrix<T> createMatrix(int rowDimension, int columnDimension) throws NotStrictlyPositiveException
createMatrix
in interface FieldMatrix<T extends FieldElement<T>>
rowDimension
- the number of rows in the new matrixcolumnDimension
- the number of columns in the new matrixNotStrictlyPositiveException
- if row or column dimension is not
positive.public abstract FieldMatrix<T> copy()
copy
in interface FieldMatrix<T extends FieldElement<T>>
public FieldMatrix<T> add(FieldMatrix<T> m) throws MatrixDimensionMismatchException
add
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to be added.this
+ m
.MatrixDimensionMismatchException
- if m
is not the same
size as this
matrix.public FieldMatrix<T> subtract(FieldMatrix<T> m) throws MatrixDimensionMismatchException
m
from this matrix.subtract
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to be subtracted.this
- m
.MatrixDimensionMismatchException
- if m
is not the same
size as this
matrix.public FieldMatrix<T> scalarAdd(T d)
scalarAdd
in interface FieldMatrix<T extends FieldElement<T>>
d
- Value to be added to each entry.d
+ this
.public FieldMatrix<T> scalarMultiply(T d)
d
.scalarMultiply
in interface FieldMatrix<T extends FieldElement<T>>
d
- Value to multiply all entries by.d
* this
.public FieldMatrix<T> multiply(FieldMatrix<T> m) throws DimensionMismatchException
m
.multiply
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to postmultiply by.this
* m
.DimensionMismatchException
- if the number of columns of
this
matrix is not equal to the number of rows of matrix
m
.public FieldMatrix<T> preMultiply(FieldMatrix<T> m) throws DimensionMismatchException
m
.preMultiply
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to premultiply by.m
* this
.DimensionMismatchException
- if the number of columns of m
differs from the number of rows of this
matrix.public FieldMatrix<T> power(int p) throws NonSquareMatrixException, NotPositiveException
p
times.
Depending on the type of the field elements, T, instability for high
powers might occur.power
in interface FieldMatrix<T extends FieldElement<T>>
p
- raise this to power pNonSquareMatrixException
- if this matrix
is not squareNotPositiveException
- if p < 0
public T[][] getData()
getData
in interface FieldMatrix<T extends FieldElement<T>>
public FieldMatrix<T> getSubMatrix(int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
getSubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
startRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column index (inclusive)NumberIsTooSmallException
- is endRow < startRow
of
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.public FieldMatrix<T> getSubMatrix(int[] selectedRows, int[] selectedColumns) throws NoDataException, NullArgumentException, OutOfRangeException
getSubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
selectedRows
- Array of row indices.selectedColumns
- Array of column indices.NoDataException
- if selectedRows
or
selectedColumns
is emptyNullArgumentException
- if selectedRows
or
selectedColumns
is null
.OutOfRangeException
- if row or column selections are not valid.public void copySubMatrix(int startRow, int endRow, int startColumn, int endColumn, T[][] destination) throws MatrixDimensionMismatchException, NumberIsTooSmallException, OutOfRangeException
copySubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
startRow
- Initial row index.endRow
- Final row index (inclusive).startColumn
- Initial column index.endColumn
- Final column index (inclusive).destination
- The array where the submatrix data should be copied
(if larger than rows/columns counts, only the upper-left part will be modified).MatrixDimensionMismatchException
- if the dimensions of
destination
are not large enough to hold the submatrix.NumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.public void copySubMatrix(int[] selectedRows, int[] selectedColumns, T[][] destination) throws MatrixDimensionMismatchException, NoDataException, NullArgumentException, OutOfRangeException
copySubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
selectedRows
- Array of row indices.selectedColumns
- Array of column indices.destination
- Arrays where the submatrix data should be copied
(if larger than rows/columns counts, only the upper-left part will be used)MatrixDimensionMismatchException
- if the dimensions of
destination
do not match those of this
.NoDataException
- if selectedRows
or
selectedColumns
is emptyNullArgumentException
- if selectedRows
or
selectedColumns
is null
.OutOfRangeException
- if the indices are not valid.public void setSubMatrix(T[][] subMatrix, int row, int column) throws DimensionMismatchException, OutOfRangeException, NoDataException, NullArgumentException
(row, column)
using data in the
input subMatrix
array. Indexes are 0-based.
Example:
Starting with
1 2 3 4 5 6 7 8 9 0 1 2and
subMatrix = {{3, 4} {5,6}}
, invoking
setSubMatrix(subMatrix,1,1))
will result in
1 2 3 4 5 3 4 8 9 5 6 2
setSubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
subMatrix
- Array containing the submatrix replacement data.row
- Row coordinate of the top-left element to be replaced.column
- Column coordinate of the top-left element to be replaced.DimensionMismatchException
- if subMatrix
is not
rectangular (not all rows have the same length).OutOfRangeException
- if subMatrix
does not fit into this
matrix from element in (row, column)
.NoDataException
- if a row or column of subMatrix
is empty.NullArgumentException
- if subMatrix
is null
.public FieldMatrix<T> getRowMatrix(int row) throws OutOfRangeException
row
as a row matrix.getRowMatrix
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be fetched.OutOfRangeException
- if the specified row index is invalid.public void setRowMatrix(int row, FieldMatrix<T> matrix) throws OutOfRangeException, MatrixDimensionMismatchException
row
as a row matrix.setRowMatrix
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be set.matrix
- Row matrix (must have one row and the same number
of columns as the instance).OutOfRangeException
- if the specified row index is invalid.MatrixDimensionMismatchException
- if the matrix dimensions do not match one instance row.public FieldMatrix<T> getColumnMatrix(int column) throws OutOfRangeException
column
as a column matrix.getColumnMatrix
in interface FieldMatrix<T extends FieldElement<T>>
column
- Column to be fetched.OutOfRangeException
- if the specified column index is invalid.public void setColumnMatrix(int column, FieldMatrix<T> matrix) throws OutOfRangeException, MatrixDimensionMismatchException
column
as a column matrix.setColumnMatrix
in interface FieldMatrix<T extends FieldElement<T>>
column
- Column to be set.matrix
- column matrix (must have one column and the same
number of rows as the instance).OutOfRangeException
- if the specified column index is invalid.MatrixDimensionMismatchException
- if the matrix dimensions do
not match one instance column.public FieldVector<T> getRowVector(int row) throws OutOfRangeException
row
as a vector.getRowVector
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be fetchedOutOfRangeException
- if the specified row index is invalid.public void setRowVector(int row, FieldVector<T> vector) throws OutOfRangeException, MatrixDimensionMismatchException
row
as a vector.setRowVector
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be set.vector
- row vector (must have the same number of columns
as the instance).OutOfRangeException
- if the specified row index is invalid.MatrixDimensionMismatchException
- if the vector dimension does not
match one instance row.public FieldVector<T> getColumnVector(int column) throws OutOfRangeException
column
as a vector.getColumnVector
in interface FieldMatrix<T extends FieldElement<T>>
column
- Column to be fetched.OutOfRangeException
- if the specified column index is invalid.public void setColumnVector(int column, FieldVector<T> vector) throws OutOfRangeException, MatrixDimensionMismatchException
column
as a vector.setColumnVector
in interface FieldMatrix<T extends FieldElement<T>>
column
- Column to be set.vector
- Column vector (must have the same number of rows
as the instance).OutOfRangeException
- if the specified column index is invalid.MatrixDimensionMismatchException
- if the vector dimension does not
match one instance column.public T[] getRow(int row) throws OutOfRangeException
row
as an array.getRow
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be fetched.OutOfRangeException
- if the specified row index is not valid.public void setRow(int row, T[] array) throws OutOfRangeException, MatrixDimensionMismatchException
row
as a row matrix.setRow
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be set.array
- Row matrix (must have the same number of columns as
the instance).OutOfRangeException
- if the specified row index is invalid.MatrixDimensionMismatchException
- if the array size does not match
one instance row.public T[] getColumn(int column) throws OutOfRangeException
col
as an array.getColumn
in interface FieldMatrix<T extends FieldElement<T>>
column
- the column to be fetchedOutOfRangeException
- if the specified column index is not valid.public void setColumn(int column, T[] array) throws OutOfRangeException, MatrixDimensionMismatchException
column
as a column matrix.setColumn
in interface FieldMatrix<T extends FieldElement<T>>
column
- the column to be setarray
- column array (must have the same number of rows as the instance)OutOfRangeException
- if the specified column index is invalid.MatrixDimensionMismatchException
- if the array size does not match
one instance column.public abstract T getEntry(int row, int column) throws OutOfRangeException
getEntry
in interface FieldMatrix<T extends FieldElement<T>>
row
- row location of entry to be fetchedcolumn
- column location of entry to be fetchedOutOfRangeException
- if the row or column index is not valid.public abstract void setEntry(int row, int column, T value) throws OutOfRangeException
setEntry
in interface FieldMatrix<T extends FieldElement<T>>
row
- row location of entry to be setcolumn
- column location of entry to be setvalue
- matrix entry to be set in row,columnOutOfRangeException
- if the row or column index is not valid.public abstract void addToEntry(int row, int column, T increment) throws OutOfRangeException
addToEntry
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row location of entry to be set.column
- Column location of entry to be set.increment
- Value to add to the current matrix entry in
(row, column)
.OutOfRangeException
- if the row or column index is not valid.public abstract void multiplyEntry(int row, int column, T factor) throws OutOfRangeException
multiplyEntry
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row location of entry to be set.column
- Column location of entry to be set.factor
- Multiplication factor for the current matrix entry
in (row,column)
OutOfRangeException
- if the row or column index is not valid.public FieldMatrix<T> transpose()
transpose
in interface FieldMatrix<T extends FieldElement<T>>
public boolean isSquare()
public abstract int getRowDimension()
getRowDimension
in interface AnyMatrix
public abstract int getColumnDimension()
getColumnDimension
in interface AnyMatrix
public T getTrace() throws NonSquareMatrixException
getTrace
in interface FieldMatrix<T extends FieldElement<T>>
NonSquareMatrixException
- if the matrix is not square.public T[] operate(T[] v) throws DimensionMismatchException
v
.operate
in interface FieldMatrix<T extends FieldElement<T>>
v
- the vector to operate onthis * v
DimensionMismatchException
- if the number of columns of
this
matrix is not equal to the size of the vector v
.public FieldVector<T> operate(FieldVector<T> v) throws DimensionMismatchException
v
.operate
in interface FieldMatrix<T extends FieldElement<T>>
v
- the vector to operate onthis * v
DimensionMismatchException
- if the number of columns of
this
matrix is not equal to the size of the vector v
.public T[] preMultiply(T[] v) throws DimensionMismatchException
v
.preMultiply
in interface FieldMatrix<T extends FieldElement<T>>
v
- the row vector to premultiply byv * this
DimensionMismatchException
- if the number of rows of this
matrix is not equal to the size of the vector v
public FieldVector<T> preMultiply(FieldVector<T> v) throws DimensionMismatchException
v
.preMultiply
in interface FieldMatrix<T extends FieldElement<T>>
v
- the row vector to premultiply byv * this
DimensionMismatchException
- if the number of rows of this
matrix is not equal to the size of the vector v
public T walkInRowOrder(FieldMatrixChangingVisitor<T> visitor)
Row order starts at upper left and iterating through all elements of a row from left to right before going to the leftmost element of the next row.
walkInRowOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesFieldMatrixChangingVisitor.end()
at the end
of the walkFieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInRowOrder(FieldMatrixPreservingVisitor<T> visitor)
Row order starts at upper left and iterating through all elements of a row from left to right before going to the leftmost element of the next row.
walkInRowOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesFieldMatrixPreservingVisitor.end()
at the end
of the walkFieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInRowOrder(FieldMatrixChangingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
Row order starts at upper left and iterating through all elements of a row from left to right before going to the leftmost element of the next row.
walkInRowOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesstartRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column indexFieldMatrixChangingVisitor.end()
at the end
of the walkNumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInRowOrder(FieldMatrixPreservingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
Row order starts at upper left and iterating through all elements of a row from left to right before going to the leftmost element of the next row.
walkInRowOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesstartRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column indexFieldMatrixPreservingVisitor.end()
at the end
of the walkNumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInColumnOrder(FieldMatrixChangingVisitor<T> visitor)
Column order starts at upper left and iterating through all elements of a column from top to bottom before going to the topmost element of the next column.
walkInColumnOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesFieldMatrixChangingVisitor.end()
at the end
of the walkFieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInColumnOrder(FieldMatrixPreservingVisitor<T> visitor)
Column order starts at upper left and iterating through all elements of a column from top to bottom before going to the topmost element of the next column.
walkInColumnOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesFieldMatrixPreservingVisitor.end()
at the end
of the walkFieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInColumnOrder(FieldMatrixChangingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
Column order starts at upper left and iterating through all elements of a column from top to bottom before going to the topmost element of the next column.
walkInColumnOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesstartRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column indexFieldMatrixChangingVisitor.end()
at the end
of the walkNumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInColumnOrder(FieldMatrixPreservingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
Column order starts at upper left and iterating through all elements of a column from top to bottom before going to the topmost element of the next column.
walkInColumnOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesstartRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column indexFieldMatrixPreservingVisitor.end()
at the end
of the walkNumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInOptimizedOrder(FieldMatrixChangingVisitor<T> visitor)
The fastest walking order depends on the exact matrix class. It may be different from traditional row or column orders.
walkInOptimizedOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesFieldMatrixChangingVisitor.end()
at the end
of the walkFieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInOptimizedOrder(FieldMatrixPreservingVisitor<T> visitor)
The fastest walking order depends on the exact matrix class. It may be different from traditional row or column orders.
walkInOptimizedOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesFieldMatrixPreservingVisitor.end()
at the end
of the walkFieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInOptimizedOrder(FieldMatrixChangingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
The fastest walking order depends on the exact matrix class. It may be different from traditional row or column orders.
walkInOptimizedOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesstartRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column index (inclusive)FieldMatrixChangingVisitor.end()
at the end
of the walkNumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInOptimizedOrder(FieldMatrixPreservingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
The fastest walking order depends on the exact matrix class. It may be different from traditional row or column orders.
walkInOptimizedOrder
in interface FieldMatrix<T extends FieldElement<T>>
visitor
- visitor used to process all matrix entriesstartRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column index (inclusive)FieldMatrixPreservingVisitor.end()
at the end
of the walkNumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.OutOfRangeException
- if the indices are not valid.FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInRowOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInRowOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInColumnOrder(FieldMatrixChangingVisitor, int, int, int, int)
,
FieldMatrix.walkInColumnOrder(FieldMatrixPreservingVisitor, int, int, int, int)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixChangingVisitor, int, int, int, int)
public String toString()
public boolean equals(Object object)
object
is a
FieldMatrix
instance with the same dimensions as this
and all corresponding matrix entries are equal.public int hashCode()
protected void checkRowIndex(int row) throws OutOfRangeException
row
- Row index to check.OutOfRangeException
- if index
is not valid.protected void checkColumnIndex(int column) throws OutOfRangeException
column
- Column index to check.OutOfRangeException
- if index
is not valid.protected void checkSubMatrixIndex(int startRow, int endRow, int startColumn, int endColumn) throws NumberIsTooSmallException, OutOfRangeException
startRow
- Initial row index.endRow
- Final row index.startColumn
- Initial column index.endColumn
- Final column index.OutOfRangeException
- if the indices are not valid.NumberIsTooSmallException
- if endRow < startRow
or
endColumn < startColumn
.protected void checkSubMatrixIndex(int[] selectedRows, int[] selectedColumns) throws NoDataException, NullArgumentException, OutOfRangeException
selectedRows
- Array of row indices.selectedColumns
- Array of column indices.NullArgumentException
- if the arrays are null
.NoDataException
- if the arrays have zero length.OutOfRangeException
- if row or column selections are not valid.protected void checkAdditionCompatible(FieldMatrix<T> m) throws MatrixDimensionMismatchException
m
- Matrix to check.MatrixDimensionMismatchException
- if the matrix is not
addition-compatible with instance.protected void checkSubtractionCompatible(FieldMatrix<T> m) throws MatrixDimensionMismatchException
m
- Matrix to check.MatrixDimensionMismatchException
- if the matrix is not
subtraction-compatible with instance.protected void checkMultiplicationCompatible(FieldMatrix<T> m) throws DimensionMismatchException
m
- Matrix to check.DimensionMismatchException
- if the matrix is not
multiplication-compatible with instance.Copyright © 2003–2016 The Apache Software Foundation. All rights reserved.