Package no.uib.cipr.matrix
Class SymmTridiagMatrix
java.lang.Object
no.uib.cipr.matrix.AbstractMatrix
no.uib.cipr.matrix.SymmTridiagMatrix
- All Implemented Interfaces:
Iterable<MatrixEntry>
,Matrix
- Direct Known Subclasses:
SPDTridiagMatrix
Symmetrical tridiagonal matrix. Storage as for
TridiagMatrix
, but only one
off-diagonal array is stored.-
Nested Class Summary
Nested classes/interfaces inherited from interface no.uib.cipr.matrix.Matrix
Matrix.Norm
-
Field Summary
Fields inherited from class no.uib.cipr.matrix.AbstractMatrix
numColumns, numRows
-
Constructor Summary
ConstructorsConstructorDescriptionSymmTridiagMatrix
(double[] diag, double[] offDiag) Constructor for SymmTridiagMatrixSymmTridiagMatrix
(double[] diag, double[] offDiag, int n) Constructor for SymmTridiagMatrixSymmTridiagMatrix
(int n) Constructor for SymmTridiagMatrixConstructor for SymmTridiagMatrixSymmTridiagMatrix
(Matrix A, boolean deep) Constructor for SymmTridiagMatrix -
Method Summary
Modifier and TypeMethodDescriptionvoid
add
(int row, int column, double value) A(row,column) += value
copy()
Creates a deep copy of the matrixdouble
get
(int row, int column) ReturnsA(row,column)
double[]
Returns the diagonal entries.double[]
Returns the off diagonal entries.iterator()
void
set
(int row, int column, double value) A(row,column) = value
X = A\B
.x = A\b
.Transposes the matrix in-place.transSolve
(Matrix B, Matrix X) X = AT\B
.transSolve
(Vector b, Vector x) x = AT\b
.zero()
Zeros all the entries in the matrix, while preserving any underlying structure.Methods inherited from class no.uib.cipr.matrix.AbstractMatrix
add, add, check, checkMultAdd, checkMultAdd, checkRank1, checkRank1, checkRank2, checkRank2, checkSize, checkSolve, checkSolve, checkTransABmultAdd, checkTransAmultAdd, checkTransBmultAdd, checkTransMultAdd, checkTranspose, checkTranspose, checkTransRank1, checkTransRank2, isSquare, max, max, mult, mult, mult, mult, multAdd, multAdd, multAdd, multAdd, norm, norm1, normF, normInf, numColumns, numRows, rank1, rank1, rank1, rank1, rank1, rank1, rank2, rank2, rank2, rank2, scale, set, set, toString, transABmult, transABmult, transABmultAdd, transABmultAdd, transAmult, transAmult, transAmultAdd, transAmultAdd, transBmult, transBmult, transBmultAdd, transBmultAdd, transMult, transMult, transMultAdd, transMultAdd, transpose, transRank1, transRank1, transRank2, transRank2
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Methods inherited from interface java.lang.Iterable
forEach, spliterator
-
Constructor Details
-
SymmTridiagMatrix
public SymmTridiagMatrix(double[] diag, double[] offDiag, int n) Constructor for SymmTridiagMatrix- Parameters:
diag
- Main diagonaloffDiag
- Offdiagonals, both upper and lowern
- Size of the matrix. The main diagonal must be at least as long as n, and the off diagonal part must be at least as long as n-1
-
SymmTridiagMatrix
public SymmTridiagMatrix(double[] diag, double[] offDiag) Constructor for SymmTridiagMatrix- Parameters:
diag
- Main diagonaloffDiag
- Offdiagonals. Must be one shorter than diag
-
SymmTridiagMatrix
public SymmTridiagMatrix(int n) Constructor for SymmTridiagMatrix- Parameters:
n
- Size of the matrix. Since the matrix must be square, this equals both the number of rows and columns.n
cannot be zero
-
SymmTridiagMatrix
Constructor for SymmTridiagMatrix- Parameters:
A
- Matrix to copy contents from. Only main and the superdiagonal is copied over
-
SymmTridiagMatrix
Constructor for SymmTridiagMatrix- Parameters:
A
- Matrix to copy contents from. Only main and the superdiagonal is copied over. It must be square and cannot have any zero dimension lengthsdeep
- True for a deep copy. For shallow copiesA
must be aSymmTridiagMatrix
-
-
Method Details
-
getDiagonal
public double[] getDiagonal()Returns the diagonal entries. Length equaln
-
getOffDiagonal
public double[] getOffDiagonal()Returns the off diagonal entries. Length equaln-1
-
add
public void add(int row, int column, double value) Description copied from interface:Matrix
A(row,column) += value
- Specified by:
add
in interfaceMatrix
- Overrides:
add
in classAbstractMatrix
-
get
public double get(int row, int column) Description copied from interface:Matrix
ReturnsA(row,column)
- Specified by:
get
in interfaceMatrix
- Overrides:
get
in classAbstractMatrix
-
set
public void set(int row, int column, double value) Description copied from interface:Matrix
A(row,column) = value
- Specified by:
set
in interfaceMatrix
- Overrides:
set
in classAbstractMatrix
-
copy
Description copied from interface:Matrix
Creates a deep copy of the matrix- Specified by:
copy
in interfaceMatrix
- Overrides:
copy
in classAbstractMatrix
- Returns:
- A
-
zero
Description copied from interface:Matrix
Zeros all the entries in the matrix, while preserving any underlying structure. Useful for general, unstructured matrices.- Specified by:
zero
in interfaceMatrix
- Overrides:
zero
in classAbstractMatrix
- Returns:
- A
-
solve
Description copied from interface:Matrix
X = A\B
. Not all matrices support this operation, those that do not throwUnsupportedOperationException
. Note that it is often more efficient to use a matrix decomposition and its associated solver- Specified by:
solve
in interfaceMatrix
- Overrides:
solve
in classAbstractMatrix
- Parameters:
B
- Matrix with the same number of rows asA
, and the same number of columns asX
X
- Matrix with a number of rows equalA.numColumns()
, and the same number of columns asB
- Returns:
- X
-
solve
Description copied from interface:Matrix
x = A\b
. Not all matrices support this operation, those that do not throwUnsupportedOperationException
. Note that it is often more efficient to use a matrix decomposition and its associated solver- Specified by:
solve
in interfaceMatrix
- Overrides:
solve
in classAbstractMatrix
- Parameters:
b
- Vector of sizeA.numRows()
x
- Vector of sizeA.numColumns()
- Returns:
- x
-
transSolve
Description copied from interface:Matrix
X = AT\B
. Not all matrices support this operation, those that do not throwUnsupportedOperationException
. Note that it is often more efficient to use a matrix decomposition and its associated transpose solver- Specified by:
transSolve
in interfaceMatrix
- Overrides:
transSolve
in classAbstractMatrix
- Parameters:
B
- Matrix with a number of rows equalA.numColumns()
, and the same number of columns asX
X
- Matrix with the same number of rows asA
, and the same number of columns asB
- Returns:
- X
-
transSolve
Description copied from interface:Matrix
x = AT\b
. Not all matrices support this operation, those that do not throwUnsupportedOperationException
. Note that it is often more efficient to use a matrix decomposition and its associated solver- Specified by:
transSolve
in interfaceMatrix
- Overrides:
transSolve
in classAbstractMatrix
- Parameters:
b
- Vector of sizeA.numColumns()
x
- Vector of sizeA.numRows()
- Returns:
- x
-
transpose
Description copied from interface:Matrix
Transposes the matrix in-place. In most cases, the matrix must be square for this to work.- Specified by:
transpose
in interfaceMatrix
- Overrides:
transpose
in classAbstractMatrix
- Returns:
- This matrix
-
iterator
- Specified by:
iterator
in interfaceIterable<MatrixEntry>
- Overrides:
iterator
in classAbstractMatrix
-