Blob Blame Raw


#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