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.
This class is up-to-date with commons-math 3.6.1.
Modifier | Constructor and Description |
---|---|
protected |
AbstractFieldMatrix()
Constructor for use with Serializable
|
protected |
AbstractFieldMatrix(Field<T> fieldIn)
Creates a matrix with no data
|
protected |
AbstractFieldMatrix(Field<T> fieldIn,
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 4.5, replaced by
MathArrays.buildArray(Field, int, int) |
protected static <T extends FieldElement<T>> |
buildArray(Field<T> field,
int rows,
int columns)
Deprecated.
as of 4.5, 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> fieldIn)
fieldIn
- field to which the elements belongprotected AbstractFieldMatrix(Field<T> fieldIn, int rowDimension, int columnDimension)
fieldIn
- 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)
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)
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, 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)
createMatrix
in interface FieldMatrix<T extends FieldElement<T>>
rowDimension
- the number of rows in the new matrixcolumnDimension
- the number of columns in the new matrixpublic abstract FieldMatrix<T> copy()
copy
in interface FieldMatrix<T extends FieldElement<T>>
public FieldMatrix<T> add(FieldMatrix<T> m)
add
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to be added.this
+ m
.public FieldMatrix<T> subtract(FieldMatrix<T> m)
m
from this matrix.subtract
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to be subtracted.this
- m
.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)
m
.multiply
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to postmultiply by.this
* m
.public FieldMatrix<T> preMultiply(FieldMatrix<T> m)
m
.preMultiply
in interface FieldMatrix<T extends FieldElement<T>>
m
- Matrix to premultiply by.m
* this
.public FieldMatrix<T> power(int p)
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 ppublic T[][] getData()
getData
in interface FieldMatrix<T extends FieldElement<T>>
public FieldMatrix<T> getSubMatrix(int startRow, int endRow, int startColumn, int endColumn)
getSubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
startRow
- Initial row indexendRow
- Final row index (inclusive)startColumn
- Initial column indexendColumn
- Final column index (inclusive)public FieldMatrix<T> getSubMatrix(int[] selectedRows, int[] selectedColumns)
getSubMatrix
in interface FieldMatrix<T extends FieldElement<T>>
selectedRows
- Array of row indices.selectedColumns
- Array of column indices.public void copySubMatrix(int startRow, int endRow, int startColumn, int endColumn, T[][] destination)
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 arrays where the submatrix data should be copied
(if larger than rows/columns counts, only the upper-left part will be used).public void copySubMatrix(int[] selectedRows, int[] selectedColumns, T[][] destination)
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)public void setSubMatrix(T[][] subMatrix, int row, int column)
(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.public FieldMatrix<T> getRowMatrix(int row)
row
as a row matrix.getRowMatrix
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be fetched.public void setRowMatrix(int row, FieldMatrix<T> matrix)
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).public FieldMatrix<T> getColumnMatrix(int column)
column
as a column matrix.getColumnMatrix
in interface FieldMatrix<T extends FieldElement<T>>
column
- Column to be fetched.public void setColumnMatrix(int column, FieldMatrix<T> matrix)
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).public FieldVector<T> getRowVector(int row)
row
as a vector.getRowVector
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be fetchedpublic void setRowVector(int row, FieldVector<T> vector)
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).public FieldVector<T> getColumnVector(int column)
column
as a vector.getColumnVector
in interface FieldMatrix<T extends FieldElement<T>>
column
- Column to be fetched.public void setColumnVector(int column, FieldVector<T> vector)
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).public T[] getRow(int row)
row
as an array.getRow
in interface FieldMatrix<T extends FieldElement<T>>
row
- Row to be fetched.public void setRow(int row, T[] array)
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).public T[] getColumn(int column)
col
as an array.getColumn
in interface FieldMatrix<T extends FieldElement<T>>
column
- the column to be fetchedpublic void setColumn(int column, T[] array)
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)public abstract T getEntry(int row, int column)
getEntry
in interface FieldMatrix<T extends FieldElement<T>>
row
- row location of entry to be fetchedcolumn
- column location of entry to be fetchedpublic abstract void setEntry(int row, int column, T value)
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,columnpublic abstract void addToEntry(int row, int column, T increment)
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)
.public abstract void multiplyEntry(int row, int column, T factor)
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)
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()
getTrace
in interface FieldMatrix<T extends FieldElement<T>>
public T[] operate(T[] v)
v
.operate
in interface FieldMatrix<T extends FieldElement<T>>
v
- the vector to operate onthis * v
public FieldVector<T> operate(FieldVector<T> v)
v
.operate
in interface FieldMatrix<T extends FieldElement<T>>
v
- the vector to operate onthis * v
public T[] preMultiply(T[] v)
v
.preMultiply
in interface FieldMatrix<T extends FieldElement<T>>
v
- the row vector to premultiply byv * this
public FieldVector<T> preMultiply(FieldVector<T> v)
v
.preMultiply
in interface FieldMatrix<T extends FieldElement<T>>
v
- the row vector to premultiply byv * this
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)
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 walkFieldMatrix.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)
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 walkFieldMatrix.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)
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 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(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)
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 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.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)
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 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(FieldMatrixPreservingVisitor)
,
FieldMatrix.walkInOptimizedOrder(FieldMatrixPreservingVisitor, int, int, int, int)
public T walkInOptimizedOrder(FieldMatrixPreservingVisitor<T> visitor, int startRow, int endRow, int startColumn, int endColumn)
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 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(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)
row
- Row index to check.OutOfRangeException
- if index
is not valid.protected void checkColumnIndex(int column)
column
- Column index to check.OutOfRangeException
- if index
is not valid.protected void checkSubMatrixIndex(int startRow, int endRow, int startColumn, int endColumn)
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)
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)
m
- Matrix to check.MatrixDimensionMismatchException
- if the matrix is not
addition-compatible with instance.protected void checkSubtractionCompatible(FieldMatrix<T> m)
m
- Matrix to check.MatrixDimensionMismatchException
- if the matrix is not
subtraction-compatible with instance.protected void checkMultiplicationCompatible(FieldMatrix<T> m)
m
- Matrix to check.DimensionMismatchException
- if the matrix is not
multiplication-compatible with instance.Copyright © 2023 CNES. All rights reserved.