Package no.uib.cipr.matrix
Class UnitLowerTriangBandMatrix
- java.lang.Object
-
- no.uib.cipr.matrix.AbstractMatrix
-
- no.uib.cipr.matrix.LowerTriangBandMatrix
-
- no.uib.cipr.matrix.UnitLowerTriangBandMatrix
-
- All Implemented Interfaces:
java.lang.Iterable<MatrixEntry>,Matrix
public class UnitLowerTriangBandMatrix extends LowerTriangBandMatrix
Unit lower triangular banded matrix. The same storage asLowerTriangBandMatrix, but the main diagonal is assumed to be all ones. It is still allocated, however.
-
-
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
Constructors Constructor Description UnitLowerTriangBandMatrix(int n, int kd)Constructor for UnitLowerTriangBandMatrixUnitLowerTriangBandMatrix(Matrix A, int kd)Constructor for UnitLowerTriangBandMatrixUnitLowerTriangBandMatrix(Matrix A, int kd, boolean deep)Constructor for UnitLowerTriangBandMatrix
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidadd(int row, int column, double value)A(row,column) += valueUnitLowerTriangBandMatrixcopy()Creates a deep copy of the matrixdoubleget(int row, int column)ReturnsA(row,column)double[]getData()Returns the matrix contentsjava.util.Iterator<MatrixEntry>iterator()Vectormult(double alpha, Vector x, Vector y)y = alpha*A*xintnumSubDiagonals()Returns the number of lower diagonalsintnumSuperDiagonals()Returns the number of upper diagonalsvoidset(int row, int column, double value)A(row,column) = valueMatrixset(Matrix B)A=B.Matrixsolve(Matrix B, Matrix X)X = A\B.Vectorsolve(Vector b, Vector x)x = A\b.VectortransMult(double alpha, Vector x, Vector y)y = alpha*AT*xMatrixtransSolve(Matrix B, Matrix X)X = AT\B.VectortransSolve(Vector b, Vector x)x = AT\b.Matrixzero()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, multAdd, multAdd, multAdd, multAdd, norm, norm1, normF, normInf, numColumns, numRows, rank1, rank1, rank1, rank1, rank1, rank1, rank2, rank2, rank2, rank2, scale, set, toString, transABmult, transABmult, transABmultAdd, transABmultAdd, transAmult, transAmult, transAmultAdd, transAmultAdd, transBmult, transBmult, transBmultAdd, transBmultAdd, transMult, transMultAdd, transMultAdd, transpose, transpose, transRank1, transRank1, transRank2, transRank2
-
-
-
-
Constructor Detail
-
UnitLowerTriangBandMatrix
public UnitLowerTriangBandMatrix(int n, int kd)Constructor for UnitLowerTriangBandMatrix- Parameters:
n- Size of the matrix. Since the matrix must be square, this equals both the number of rows and columnskd- Number of bands below the main diagonal (subdiagonals)
-
UnitLowerTriangBandMatrix
public UnitLowerTriangBandMatrix(Matrix A, int kd)
Constructor for UnitLowerTriangBandMatrix- Parameters:
A- Matrix to copy contents from. Only the parts ofAthat lie within the allocated band are copied over, the rest is ignored (including main diagonal entries)kd- Number of bands below the main diagonal (subdiagonals)
-
UnitLowerTriangBandMatrix
public UnitLowerTriangBandMatrix(Matrix A, int kd, boolean deep)
Constructor for UnitLowerTriangBandMatrix- Parameters:
A- Matrix to copy contents from. Only the parts ofAthat lie within the allocated band are copied over, the rest is ignored (including main diagonal entries)kd- Number of bands below the main diagonal (subdiagonals)deep- True for a deep copy. For shallow copies,Amust be a banded matrix
-
-
Method Detail
-
add
public void add(int row, int column, double value)Description copied from interface:MatrixA(row,column) += value
-
get
public double get(int row, int column)Description copied from interface:MatrixReturnsA(row,column)
-
set
public void set(int row, int column, double value)Description copied from interface:MatrixA(row,column) = value
-
copy
public UnitLowerTriangBandMatrix copy()
Description copied from interface:MatrixCreates a deep copy of the matrix- Specified by:
copyin interfaceMatrix- Overrides:
copyin classLowerTriangBandMatrix- Returns:
- A
-
zero
public Matrix zero()
Description copied from interface:MatrixZeros all the entries in the matrix, while preserving any underlying structure. Useful for general, unstructured matrices.
-
mult
public Vector mult(double alpha, Vector x, Vector y)
Description copied from interface:Matrixy = alpha*A*x- Specified by:
multin interfaceMatrix- Overrides:
multin classAbstractMatrixx- Vector of sizeA.numColumns()y- Vector of sizeA.numRows()- Returns:
- y
-
transMult
public Vector transMult(double alpha, Vector x, Vector y)
Description copied from interface:Matrixy = alpha*AT*x- Specified by:
transMultin interfaceMatrix- Overrides:
transMultin classAbstractMatrixx- Vector of sizeA.numRows()y- Vector of sizeA.numColumns()- Returns:
- y
-
solve
public Matrix solve(Matrix B, Matrix X)
Description copied from interface:MatrixX = 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:
solvein interfaceMatrix- Overrides:
solvein classAbstractMatrix- Parameters:
B- Matrix with the same number of rows asA, and the same number of columns asXX- Matrix with a number of rows equalA.numColumns(), and the same number of columns asB- Returns:
- X
-
solve
public Vector solve(Vector b, Vector x)
Description copied from interface:Matrixx = 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:
solvein interfaceMatrix- Overrides:
solvein classAbstractMatrix- Parameters:
b- Vector of sizeA.numRows()x- Vector of sizeA.numColumns()- Returns:
- x
-
transSolve
public Matrix transSolve(Matrix B, Matrix X)
Description copied from interface:MatrixX = 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:
transSolvein interfaceMatrix- Overrides:
transSolvein classAbstractMatrix- Parameters:
B- Matrix with a number of rows equalA.numColumns(), and the same number of columns asXX- Matrix with the same number of rows asA, and the same number of columns asB- Returns:
- X
-
transSolve
public Vector transSolve(Vector b, Vector x)
Description copied from interface:Matrixx = 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:
transSolvein interfaceMatrix- Overrides:
transSolvein classAbstractMatrix- Parameters:
b- Vector of sizeA.numColumns()x- Vector of sizeA.numRows()- Returns:
- x
-
getData
public double[] getData()
Returns the matrix contents
-
numSubDiagonals
public int numSubDiagonals()
Returns the number of lower diagonals
-
numSuperDiagonals
public int numSuperDiagonals()
Returns the number of upper diagonals
-
set
public Matrix set(Matrix B)
Description copied from interface:MatrixA=B. The matrices must be of the same size- Specified by:
setin interfaceMatrix- Overrides:
setin classAbstractMatrix- Returns:
- A
-
iterator
public java.util.Iterator<MatrixEntry> iterator()
- Specified by:
iteratorin interfacejava.lang.Iterable<MatrixEntry>- Overrides:
iteratorin classAbstractMatrix
-
-