#ifndef TLIN_SPARSEMAT_H
#define TLIN_SPARSEMAT_H
#include "tlin_basicops.h"
#include "tcg/tcg_hash.h"
namespace tlin
{
//-------------------------------------------------------------------------------
/*!
The tlin::sparse_matrix class implements a hash-based format for storing sparse
matrices.
A tlin::sparse_matrix is a tlin::matrix-compliant class that allows the user to
access the matrix in a purely random fashion, without sacrificing storage space or
efficiency. This is achieved using a single, fast, dynamic hash container that maps
(row, col) entries into their values, the hash function being like:
(row, col) -> row * nCols + col; (taken modulo nBuckets)
Observe that if the number of buckets of the hash map is nCols, the resulting
representation is similar to a CCS (Harwell-Boeing), with the difference that
buckets are not sorted by row.
*/
template <typename T>
class sparse_matrix
{
public:
struct IdxFunctor {
int m_cols;
IdxFunctor(int cols) : m_cols(cols) {}
int operator()(const std::pair<int, int> &key) { return key.first * m_cols + key.second; }
};
private:
int m_rows;
int m_cols;
tcg::hash<std::pair<int, int>, T, IdxFunctor> m_hash;
public:
sparse_matrix() : m_rows(0), m_cols(0), m_hash(IdxFunctor(0)) {}
sparse_matrix(int rows, int cols) : m_rows(rows), m_cols(cols), m_hash(cols) {}
~sparse_matrix() {}
sparse_matrix(const sparse_matrix &mat) : m_rows(mat.m_rows), m_cols(mat.m_cols), m_hash(mat.m_hash) {}
sparse_matrix &operator=(const sparse_matrix &mat)
{
m_rows = mat.m_rows, m_cols = mat.m_cols, m_hash = mat.m_hash;
return *this;
}
int rows() const { return m_rows; }
int cols() const { return m_cols; }
typedef typename tcg::hash<std::pair<int, int>, T, IdxFunctor> HashMap;
tcg::hash<std::pair<int, int>, T, IdxFunctor> &entries() { return m_hash; }
const tcg::hash<std::pair<int, int>, T, IdxFunctor> &entries() const { return m_hash; }
//!\warning Assignments of kind: A.at(1,1) = A.at(0,0) are potentially harmful.
//!Use A.get(x,y) on the right side instead.
T &at(int row, int col) { return m_hash.touch(std::make_pair(row, col), 0); }
const T get(int row, int col) const
{
typename HashMap::const_iterator it = m_hash.find(std::make_pair(row, col));
return (it == m_hash.end()) ? 0 : it->m_val;
}
const T operator()(int row, int col) const { return get(row, col); }
void clear() { m_hash.clear(); }
friend void swap(sparse_matrix &a, sparse_matrix &b)
{
using std::swap;
swap(a.m_rows, b.m_rows), swap(a.m_cols, b.m_cols);
swap(a.m_hash, b.m_hash);
}
};
//-------------------------------------------------------------------
// The Standard matrix data type in tlin is double
typedef tlin::sparse_matrix<double> spmat;
}
#endif //TLIN_SPARSEMAT_H