Sparse Array-matrix class. More...
#include <Matrix_ArraySparse.hxx>
Public Member Functions | |
Matrix_ArraySparse () | |
Default constructor. More... | |
Matrix_ArraySparse (int i, int j) | |
Constructor. More... | |
~Matrix_ArraySparse () | |
Destructor. | |
void | Clear () |
Clears the matrix. More... | |
void | Reallocate (int i, int j) |
Reallocates memory to resize the matrix. More... | |
void | Resize (int i, int j) |
Reallocates additional memory to resize the matrix. More... | |
long | GetNonZeros () const |
Returns the number of non-zero entries. More... | |
size_t | GetMemorySize () const |
returns size of matrix in bytes | |
long | GetDataSize () const |
Returns the number of elements stored in memory. More... | |
int * | GetIndex (int i) const |
Returns (row or column) indices of non-zero entries in row. More... | |
T * | GetData (int i) const |
Returns values of non-zero entries of a row/column. More... | |
Vector< T, VectSparse, Allocator > * | GetData () const |
Returns values of non-zero entries. More... | |
const T | operator() (int i, int j) const |
Access operator. More... | |
T & | Get (int i, int j) |
Access to element (i, j). More... | |
const T & | Get (int i, int j) const |
Access to element (i, j). More... | |
T & | Val (int i, int j) |
Access method. More... | |
const T & | Val (int i, int j) const |
Access operator. More... | |
void | Set (int i, int j, const T &x) |
Sets an element of the matrix. More... | |
void | SetEntry (int i, int j, const T &x) |
Sets an element of the matrix. More... | |
const T & | Value (int num_row, int i) const |
Returns j-th non-zero value of row/column i. More... | |
T & | Value (int num_row, int i) |
Returns j-th non-zero value of row/column i. More... | |
int | Index (int num_row, int i) const |
Returns column/row number of j-th non-zero value of row/column i. More... | |
int & | Index (int num_row, int i) |
Returns column/row number of j-th non-zero value of row/column i. More... | |
void | SetData (int, int, Vector< T, VectSparse, Allocator > *) |
Redefines the matrix. More... | |
void | SetData (int, int, T *, int *) |
Redefines a row/column of the matrix. More... | |
void | Nullify (int i) |
Clears a row without releasing memory. More... | |
void | Nullify () |
Clears the matrix without releasing memory. More... | |
void | Print () const |
Displays the matrix on the standard output. More... | |
void | Assemble () |
Assembles the matrix. More... | |
template<class T0 > | |
void | RemoveSmallEntry (const T0 &epsilon) |
Removes small coefficients from entries. More... | |
void | SetIdentity () |
Matrix is initialized to the identity matrix. | |
void | Zero () |
Non-zero entries are set to 0 (but not removed). | |
void | Fill () |
Non-zero entries are filled with values 0, 1, 2, 3 ... | |
template<class T0 > | |
void | Fill (const T0 &x) |
Non-zero entries are set to a given value x. | |
template<class T0 > | |
Matrix_ArraySparse< T, Prop, Storage, Allocator > & | operator= (const T0 &x) |
Non-zero entries are set to a given value x. | |
void | FillRand () |
Non-zero entries take a random value. | |
void | Write (string FileName) const |
Writes the matrix in a file. More... | |
void | Write (ostream &FileStream) const |
Writes the matrix to an output stream. More... | |
void | WriteText (string FileName, bool cplx=false) const |
Writes the matrix in a file. More... | |
void | WriteText (ostream &FileStream, bool cplx=false) const |
Writes the matrix to an output stream. More... | |
void | Read (string FileName) |
Reads the matrix from a file. More... | |
void | Read (istream &FileStream) |
Reads the matrix from an input stream. More... | |
void | ReadText (string FileName, bool cplx=false) |
Reads the matrix from a file. More... | |
void | ReadText (istream &FileStream, bool cplx=false) |
Reads the matrix from an input stream. More... | |
int | GetM () const |
Returns the number of rows. More... | |
int | GetM (const Seldon::SeldonTranspose &status) const |
Returns the number of rows of the matrix possibly transposed. More... | |
int | GetM (const CBLAS_TRANSPOSE &status) const |
Returns the number of rows of the matrix possibly transposed. More... | |
int | GetN () const |
Returns the number of columns. More... | |
int | GetN (const Seldon::SeldonTranspose &status) const |
Returns the number of columns of the matrix possibly transposed. More... | |
int | GetN (const CBLAS_TRANSPOSE &status) const |
Returns the number of columns of the matrix possibly transposed. More... | |
long | GetSize () const |
Returns the number of elements in the matrix. More... | |
Protected Attributes | |
Vector< Vector< T, VectSparse, Allocator >, VectFull, NewAlloc< Vector< T, VectSparse, Allocator > > > | val_ |
rows or columns | |
int | m_ |
int | n_ |
Sparse Array-matrix class.
Sparse matrices are defined by: (1) the number of rows and columns; (2) the number of non-zero entries; (3) an array of vectors ind ind(i) is a vector, which contains indices of columns of the row i (4) an array of vectors val : val(i) is a vector, which contains values of the row i
Definition at line 38 of file Matrix_ArraySparse.hxx.
|
inline |
Default constructor.
Builds an empty matrix.
Definition at line 32 of file Matrix_ArraySparseInline.cxx.
|
inlineexplicit |
Constructor.
Builds a i by j sparse matrix.
i | number of rows. |
j | number of columns. |
Definition at line 46 of file Matrix_ArraySparseInline.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Assemble |
Assembles the matrix.
All the column/row numbers are sorted. If same column/row numbers exist, values are added.
Definition at line 159 of file Matrix_ArraySparse.cxx.
|
inline |
Clears the matrix.
This methods is equivalent to the destructor. On exit, the matrix is empty (0 by 0).
Definition at line 66 of file Matrix_ArraySparseInline.cxx.
|
inline |
Access to element (i, j).
Returns the value of element (i, j).
i | row index. |
j | column index. |
Definition at line 178 of file Matrix_ArraySparseInline.cxx.
|
inline |
Access to element (i, j).
Returns the value of element (i, j).
[in] | i | row index. |
[in] | j | column index. |
Definition at line 198 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns values of non-zero entries.
Definition at line 127 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns values of non-zero entries of a row/column.
[in] | i | row (or column) number. |
Definition at line 114 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns the number of elements stored in memory.
Returns the number of elements stored in memory, i.e. the number of non-zero entries.
Definition at line 86 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns (row or column) indices of non-zero entries in row.
[in] | i | row (or column) number. |
Definition at line 100 of file Matrix_ArraySparseInline.cxx.
|
inlineinherited |
Returns the number of rows.
Definition at line 69 of file Matrix_BaseInline.cxx.
|
inlineinherited |
Returns the number of rows of the matrix possibly transposed.
status | assumed status about the transposition of the matrix. |
Definition at line 122 of file Matrix_BaseInline.cxx.
|
inlineinherited |
Returns the number of rows of the matrix possibly transposed.
status | assumed status about the transposition of the matrix. |
Definition at line 92 of file Matrix_BaseInline.cxx.
|
inlineinherited |
Returns the number of columns.
Definition at line 80 of file Matrix_BaseInline.cxx.
|
inlineinherited |
Returns the number of columns of the matrix possibly transposed.
status | assumed status about the transposition of the matrix. |
Definition at line 137 of file Matrix_BaseInline.cxx.
|
inlineinherited |
Returns the number of columns of the matrix possibly transposed.
status | assumed status about the transposition of the matrix. |
Definition at line 107 of file Matrix_BaseInline.cxx.
long Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::GetNonZeros |
Returns the number of non-zero entries.
Definition at line 97 of file Matrix_ArraySparse.cxx.
|
inlineinherited |
Returns the number of elements in the matrix.
Returns the number of elements in the matrix, i.e. the number of rows multiplied by the number of columns.
Definition at line 153 of file Matrix_BaseInline.cxx.
|
inline |
Returns column/row number of j-th non-zero value of row/column i.
[in] | i | row/column number. |
[in] | j | local number. |
Definition at line 345 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns column/row number of j-th non-zero value of row/column i.
[in] | i | row/column number. |
[in] | j | local number. |
Definition at line 325 of file Matrix_ArraySparseInline.cxx.
|
inline |
Clears the matrix without releasing memory.
On exit, the matrix is empty and the memory has not been released. It is useful for low level manipulations on a Matrix instance.
Definition at line 406 of file Matrix_ArraySparseInline.cxx.
|
inline |
Clears a row without releasing memory.
On exit, the row is empty and the memory has not been released. It is useful for low level manipulations on a Matrix instance.
Definition at line 378 of file Matrix_ArraySparseInline.cxx.
|
inline |
Access operator.
Returns the value of element (i, j).
[in] | i | row index. |
[in] | j | column index. |
Definition at line 157 of file Matrix_ArraySparseInline.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Print |
Displays the matrix on the standard output.
Displays elements on the standard output, in text format. Each row is displayed on a single line and elements of a row are delimited by tabulations.
Definition at line 132 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Read | ( | istream & | FileStream | ) |
Reads the matrix from an input stream.
Reads a matrix in binary format from an input stream. The number of rows (integer) and the number of columns (integer) are read and matrix elements are then read in the same order as it should be in memory (e.g. row-major storage).
FileStream | output file name. |
Definition at line 399 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Read | ( | string | FileName | ) |
Reads the matrix from a file.
Reads a matrix stored in binary format in a file. The number of rows (integer) and the number of columns (integer) are read and matrix elements are then read in the same order as it should be in memory (e.g. row-major storage).
FileName | output file name. |
Definition at line 371 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::ReadText | ( | istream & | FileStream, |
bool | cplx = false |
||
) |
Reads the matrix from an input stream.
Reads a matrix from a stream in text format.
FileStream | input stream. |
Definition at line 462 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::ReadText | ( | string | FileName, |
bool | cplx = false |
||
) |
Reads the matrix from a file.
Reads the matrix from a file in text format.
FileName | input file name. |
Definition at line 437 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Reallocate | ( | int | i, |
int | j | ||
) |
Reallocates memory to resize the matrix.
On exit, the matrix is a i x j matrix.
i | number of rows. |
j | number of columns. |
Definition at line 42 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::RemoveSmallEntry | ( | const T0 & | epsilon | ) |
Removes small coefficients from entries.
[in] | epsilon | entries whose values are below epsilon are removed. |
Definition at line 173 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Resize | ( | int | i, |
int | j | ||
) |
Reallocates additional memory to resize the matrix.
On exit, the matrix is a i x j matrix.
i | number of rows. |
j | number of columns. Data is kept |
Definition at line 63 of file Matrix_ArraySparse.cxx.
|
inline |
Sets an element of the matrix.
i | row index. |
j | column index. |
x | new value for the matrix element (i, j). |
Definition at line 258 of file Matrix_ArraySparseInline.cxx.
|
inline |
Redefines a row/column of the matrix.
[in] | i | row/col number |
[in] | n | number of non-zero entries in the row |
[in] | val | values |
[in] | ind | column numbers |
Definition at line 366 of file Matrix_ArraySparseInline.cxx.
|
inline |
Redefines the matrix.
[in] | m | new number of rows. |
[in] | n | new number of columns. |
[in] | val | array of sparse rows/columns. |
Definition at line 392 of file Matrix_ArraySparseInline.cxx.
|
inline |
Sets an element of the matrix.
i | row index. |
j | column index. |
x | new value for the matrix element (i, j). |
Definition at line 272 of file Matrix_ArraySparseInline.cxx.
|
inline |
Access method.
Returns the value of element (i, j).
[in] | i | row index. |
[in] | j | column index. |
Definition at line 217 of file Matrix_ArraySparseInline.cxx.
|
inline |
Access operator.
Returns the value of element (i, j).
i | row index. |
j | column index. |
Definition at line 238 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns j-th non-zero value of row/column i.
[in] | i | row/column number. |
[in] | j | local number. |
Definition at line 306 of file Matrix_ArraySparseInline.cxx.
|
inline |
Returns j-th non-zero value of row/column i.
[in] | i | row/column number. |
[in] | j | local number. |
Definition at line 286 of file Matrix_ArraySparseInline.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Write | ( | ostream & | FileStream | ) | const |
Writes the matrix to an output stream.
Stores the matrix in a file in binary format. The number of rows (integer) and the number of columns (integer) are written and matrix elements are then written in the same order as in memory (e.g. row-major storage).
FileStream | output file name. |
Definition at line 287 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::Write | ( | string | FileName | ) | const |
Writes the matrix in a file.
Stores the matrix in a file in binary format. The number of rows (integer) and the number of columns (integer) are written and matrix elements are then written in the same order as in memory (e.g. row-major storage).
FileName | output file name. |
Definition at line 259 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::WriteText | ( | ostream & | FileStream, |
bool | cplx = false |
||
) | const |
Writes the matrix to an output stream.
Stores the matrix in a file in ascii format. The entries are written in coordinate format (row column value). 1-index convention is used.
FileStream | output file name. |
Definition at line 342 of file Matrix_ArraySparse.cxx.
void Seldon::Matrix_ArraySparse< T, Prop, Storage, Allocator >::WriteText | ( | string | FileName, |
bool | cplx = false |
||
) | const |
Writes the matrix in a file.
Stores the matrix in a file in ascii format. The entries are written in coordinate format (row column value). 1-index convention is used.
FileName | output file name. |
Definition at line 314 of file Matrix_ArraySparse.cxx.