OpenCV 4.10.0-dev
Open Source Computer Vision
Loading...
Searching...
No Matches
cv::SparseMat_< _Tp > Class Template Reference

Template sparse n-dimensional array class derived from SparseMat. More...

#include <opencv2/core/mat.hpp>

Collaboration diagram for cv::SparseMat_< _Tp >:

Public Types

typedef SparseMatConstIterator_< _Tpconst_iterator
 
typedef SparseMatIterator_< _Tpiterator
 
- Public Types inherited from cv::SparseMat
enum  {
  MAGIC_VAL =0x42FD0000 ,
  MAX_DIM =32 ,
  HASH_SCALE =0x5bd1e995 ,
  HASH_BIT =0x80000000
}
 
typedef SparseMatConstIterator const_iterator
 
typedef SparseMatIterator iterator
 

Public Member Functions

 SparseMat_ ()
 the default constructor
 
 SparseMat_ (const Mat &m)
 converts dense matrix to the sparse form
 
 SparseMat_ (const SparseMat &m)
 the copy constructor. If DataType<_Tp>.type != m.type(), the m elements are converted
 
 SparseMat_ (const SparseMat_ &m)
 the copy constructor. This is O(1) operation - no data is copied
 
 SparseMat_ (int dims, const int *_sizes)
 the full constructor equivalent to SparseMat(dims, _sizes, DataType<_Tp>::type)
 
SparseMatIterator_< _Tpbegin ()
 returns sparse matrix iterator pointing to the first sparse matrix element
 
SparseMatConstIterator_< _Tpbegin () const
 returns read-only sparse matrix iterator pointing to the first sparse matrix element
 
int channels () const
 returns the number of channels in each matrix element
 
CV_NODISCARD_STD SparseMat_ clone () const
 makes full copy of the matrix. All the elements are duplicated
 
void create (int dims, const int *_sizes)
 equivalent to cv::SparseMat::create(dims, _sizes, DataType<_Tp>::type)
 
int depth () const
 returns depth of the matrix elements
 
SparseMatIterator_< _Tpend ()
 returns sparse matrix iterator pointing to the element following the last sparse matrix element
 
SparseMatConstIterator_< _Tpend () const
 returns read-only sparse matrix iterator pointing to the element following the last sparse matrix element
 
_Tp operator() (const int *idx, size_t *hashval=0) const
 equivalent to SparseMat::value<_Tp>(idx, hashval)
 
_Tp operator() (int i0, int i1, int i2, size_t *hashval=0) const
 equivalent to SparseMat::value<_Tp>(i0, i1, i2, hashval)
 
_Tp operator() (int i0, int i1, size_t *hashval=0) const
 equivalent to SparseMat::value<_Tp>(i0, i1, hashval)
 
_Tp operator() (int i0, size_t *hashval=0) const
 equivalent to SparseMat::value<_Tp>(i0, hashval)
 
SparseMat_operator= (const Mat &m)
 converts dense matrix to the sparse form
 
SparseMat_operator= (const SparseMat &m)
 converts the old-style sparse matrix to the C++ class. All the elements are copied
 
SparseMat_operator= (const SparseMat_ &m)
 the assignment operator. This is O(1) operation - no data is copied
 
_Tpref (const int *idx, size_t *hashval=0)
 equivalent to SparseMat::ref<_Tp>(idx, hashval)
 
_Tpref (int i0, int i1, int i2, size_t *hashval=0)
 equivalent to SparseMat::ref<_Tp>(i0, i1, i2, hashval)
 
_Tpref (int i0, int i1, size_t *hashval=0)
 equivalent to SparseMat::ref<_Tp>(i0, i1, hashval)
 
_Tpref (int i0, size_t *hashval=0)
 equivalent to SparseMat::ref<_Tp>(i0, hashval)
 
int type () const
 converts sparse matrix to the old-style CvSparseMat. All the elements are copied
 
- Public Member Functions inherited from cv::SparseMat
 SparseMat ()
 Various SparseMat constructors.
 
 SparseMat (const Mat &m)
 
 SparseMat (const SparseMat &m)
 
 SparseMat (int dims, const int *_sizes, int _type)
 
 ~SparseMat ()
 the destructor
 
void addref ()
 manually increments the reference counter to the header.
 
void assignTo (SparseMat &m, int type=-1) const
 
int channels () const
 returns the number of channels
 
void clear ()
 sets all the sparse matrix elements to 0, which means clearing the hash table.
 
CV_NODISCARD_STD SparseMat clone () const
 creates full copy of the matrix
 
void convertTo (Mat &m, int rtype, double alpha=1, double beta=0) const
 converts sparse matrix to dense n-dim matrix with optional type conversion and scaling.
 
void convertTo (SparseMat &m, int rtype, double alpha=1) const
 multiplies all the matrix elements by the specified scale factor alpha and converts the results to the specified data type
 
void copyTo (Mat &m) const
 converts sparse matrix to dense matrix.
 
void copyTo (SparseMat &m) const
 copies all the data to the destination matrix. All the previous content of m is erased
 
void create (int dims, const int *_sizes, int _type)
 reallocates sparse matrix.
 
int depth () const
 returns the depth of sparse matrix elements
 
int dims () const
 returns the matrix dimensionality
 
size_t elemSize () const
 converts sparse matrix to the old-style representation; all the elements are copied.
 
size_t elemSize1 () const
 returns elemSize()/channels()
 
SparseMatIterator end ()
 returns the sparse matrix iterator at the matrix end
 
template<typename _Tp >
SparseMatIterator_< _Tpend ()
 returns the typed sparse matrix iterator at the matrix end
 
SparseMatConstIterator end () const
 returns the read-only sparse matrix iterator at the matrix end
 
template<typename _Tp >
SparseMatConstIterator_< _Tpend () const
 returns the typed read-only sparse matrix iterator at the matrix end
 
void erase (const int *idx, size_t *hashval=0)
 erases the specified element (nD case)
 
void erase (int i0, int i1, int i2, size_t *hashval=0)
 erases the specified element (3D case)
 
void erase (int i0, int i1, size_t *hashval=0)
 erases the specified element (2D case)
 
size_t hash (const int *idx) const
 computes the element hash value (nD case)
 
size_t hash (int i0) const
 computes the element hash value (1D case)
 
size_t hash (int i0, int i1) const
 computes the element hash value (2D case)
 
size_t hash (int i0, int i1, int i2) const
 computes the element hash value (3D case)
 
ucharnewNode (const int *idx, size_t hashval)
 
Nodenode (size_t nidx)
 
const Nodenode (size_t nidx) const
 
size_t nzcount () const
 returns the number of non-zero elements (=the number of hash table nodes)
 
SparseMatoperator= (const Mat &m)
 equivalent to the corresponding constructor
 
SparseMatoperator= (const SparseMat &m)
 assignment operator. This is O(1) operation, i.e. no data is copied
 
void release ()
 
void removeNode (size_t hidx, size_t nidx, size_t previdx)
 
void resizeHashTab (size_t newsize)
 
const int * size () const
 returns the array of sizes, or NULL if the matrix is not allocated
 
int size (int i) const
 returns the size of i-th matrix dimension (or 0)
 
int type () const
 returns type of sparse matrix elements
 
template<typename _Tp >
const _Tpvalue (const Node *n) const
 returns the value stored in the sparse martix node
 
template<typename _Tp >
_Tpvalue (Node *n)
 returns the value stored in the sparse martix node
 
ucharptr (int i0, bool createMissing, size_t *hashval=0)
 returns pointer to the specified element (1D case)
 
ucharptr (int i0, int i1, bool createMissing, size_t *hashval=0)
 returns pointer to the specified element (2D case)
 
ucharptr (int i0, int i1, int i2, bool createMissing, size_t *hashval=0)
 returns pointer to the specified element (3D case)
 
ucharptr (const int *idx, bool createMissing, size_t *hashval=0)
 returns pointer to the specified element (nD case)
 
template<typename _Tp >
_Tpref (int i0, size_t *hashval=0)
 returns reference to the specified element (1D case)
 
template<typename _Tp >
_Tpref (int i0, int i1, size_t *hashval=0)
 returns reference to the specified element (2D case)
 
template<typename _Tp >
_Tpref (int i0, int i1, int i2, size_t *hashval=0)
 returns reference to the specified element (3D case)
 
template<typename _Tp >
_Tpref (const int *idx, size_t *hashval=0)
 returns reference to the specified element (nD case)
 
template<typename _Tp >
_Tp value (int i0, size_t *hashval=0) const
 returns value of the specified element (1D case)
 
template<typename _Tp >
_Tp value (int i0, int i1, size_t *hashval=0) const
 returns value of the specified element (2D case)
 
template<typename _Tp >
_Tp value (int i0, int i1, int i2, size_t *hashval=0) const
 returns value of the specified element (3D case)
 
template<typename _Tp >
_Tp value (const int *idx, size_t *hashval=0) const
 returns value of the specified element (nD case)
 
template<typename _Tp >
const _Tpfind (int i0, size_t *hashval=0) const
 returns pointer to the specified element (1D case)
 
template<typename _Tp >
const _Tpfind (int i0, int i1, size_t *hashval=0) const
 returns pointer to the specified element (2D case)
 
template<typename _Tp >
const _Tpfind (int i0, int i1, int i2, size_t *hashval=0) const
 returns pointer to the specified element (3D case)
 
template<typename _Tp >
const _Tpfind (const int *idx, size_t *hashval=0) const
 returns pointer to the specified element (nD case)
 
SparseMatIterator begin ()
 returns the sparse matrix iterator at the matrix beginning
 
template<typename _Tp >
SparseMatIterator_< _Tpbegin ()
 returns the sparse matrix iterator at the matrix beginning
 
SparseMatConstIterator begin () const
 returns the read-only sparse matrix iterator at the matrix beginning
 
template<typename _Tp >
SparseMatConstIterator_< _Tpbegin () const
 returns the read-only sparse matrix iterator at the matrix beginning
 

Additional Inherited Members

- Public Attributes inherited from cv::SparseMat
int flags
 
Hdrhdr
 

Detailed Description

template<typename _Tp>
class cv::SparseMat_< _Tp >

Template sparse n-dimensional array class derived from SparseMat.

SparseMat_ is a thin wrapper on top of SparseMat created in the same way as Mat_ . It simplifies notation of some operations:

int sz[] = {10, 20, 30};
...
M.ref(1, 2, 3) = M(4, 5, 6) + M(7, 8, 9);
Template sparse n-dimensional array class derived from SparseMat.
Definition mat.hpp:3030

Member Typedef Documentation

◆ const_iterator

template<typename _Tp >
SparseMatConstIterator_<_Tp> cv::SparseMat_< _Tp >::const_iterator

◆ iterator

template<typename _Tp >
SparseMatIterator_<_Tp> cv::SparseMat_< _Tp >::iterator

Constructor & Destructor Documentation

◆ SparseMat_() [1/5]

template<typename _Tp >
cv::SparseMat_< _Tp >::SparseMat_ ( )

the default constructor

◆ SparseMat_() [2/5]

template<typename _Tp >
cv::SparseMat_< _Tp >::SparseMat_ ( int dims,
const int * _sizes )

the full constructor equivalent to SparseMat(dims, _sizes, DataType<_Tp>::type)

◆ SparseMat_() [3/5]

template<typename _Tp >
cv::SparseMat_< _Tp >::SparseMat_ ( const SparseMat & m)

the copy constructor. If DataType<_Tp>.type != m.type(), the m elements are converted

◆ SparseMat_() [4/5]

template<typename _Tp >
cv::SparseMat_< _Tp >::SparseMat_ ( const SparseMat_< _Tp > & m)

the copy constructor. This is O(1) operation - no data is copied

◆ SparseMat_() [5/5]

template<typename _Tp >
cv::SparseMat_< _Tp >::SparseMat_ ( const Mat & m)

converts dense matrix to the sparse form

Member Function Documentation

◆ begin() [1/2]

template<typename _Tp >
SparseMatIterator_< _Tp > cv::SparseMat_< _Tp >::begin ( )

returns sparse matrix iterator pointing to the first sparse matrix element

◆ begin() [2/2]

template<typename _Tp >
SparseMatConstIterator_< _Tp > cv::SparseMat_< _Tp >::begin ( ) const

returns read-only sparse matrix iterator pointing to the first sparse matrix element

◆ channels()

template<typename _Tp >
int cv::SparseMat_< _Tp >::channels ( ) const

returns the number of channels in each matrix element

◆ clone()

template<typename _Tp >
CV_NODISCARD_STD SparseMat_ cv::SparseMat_< _Tp >::clone ( ) const

makes full copy of the matrix. All the elements are duplicated

◆ create()

template<typename _Tp >
void cv::SparseMat_< _Tp >::create ( int dims,
const int * _sizes )

equivalent to cv::SparseMat::create(dims, _sizes, DataType<_Tp>::type)

◆ depth()

template<typename _Tp >
int cv::SparseMat_< _Tp >::depth ( ) const

returns depth of the matrix elements

◆ end() [1/2]

template<typename _Tp >
SparseMatIterator_< _Tp > cv::SparseMat_< _Tp >::end ( )

returns sparse matrix iterator pointing to the element following the last sparse matrix element

◆ end() [2/2]

template<typename _Tp >
SparseMatConstIterator_< _Tp > cv::SparseMat_< _Tp >::end ( ) const

returns read-only sparse matrix iterator pointing to the element following the last sparse matrix element

◆ operator()() [1/4]

template<typename _Tp >
_Tp cv::SparseMat_< _Tp >::operator() ( const int * idx,
size_t * hashval = 0 ) const

equivalent to SparseMat::value<_Tp>(idx, hashval)

◆ operator()() [2/4]

template<typename _Tp >
_Tp cv::SparseMat_< _Tp >::operator() ( int i0,
int i1,
int i2,
size_t * hashval = 0 ) const

equivalent to SparseMat::value<_Tp>(i0, i1, i2, hashval)

◆ operator()() [3/4]

template<typename _Tp >
_Tp cv::SparseMat_< _Tp >::operator() ( int i0,
int i1,
size_t * hashval = 0 ) const

equivalent to SparseMat::value<_Tp>(i0, i1, hashval)

◆ operator()() [4/4]

template<typename _Tp >
_Tp cv::SparseMat_< _Tp >::operator() ( int i0,
size_t * hashval = 0 ) const

equivalent to SparseMat::value<_Tp>(i0, hashval)

◆ operator=() [1/3]

template<typename _Tp >
SparseMat_ & cv::SparseMat_< _Tp >::operator= ( const Mat & m)

converts dense matrix to the sparse form

◆ operator=() [2/3]

template<typename _Tp >
SparseMat_ & cv::SparseMat_< _Tp >::operator= ( const SparseMat & m)

converts the old-style sparse matrix to the C++ class. All the elements are copied

the assignment operator. If DataType<_Tp>.type != m.type(), the m elements are converted

◆ operator=() [3/3]

template<typename _Tp >
SparseMat_ & cv::SparseMat_< _Tp >::operator= ( const SparseMat_< _Tp > & m)

the assignment operator. This is O(1) operation - no data is copied

◆ ref() [1/4]

template<typename _Tp >
_Tp & cv::SparseMat_< _Tp >::ref ( const int * idx,
size_t * hashval = 0 )

equivalent to SparseMat::ref<_Tp>(idx, hashval)

◆ ref() [2/4]

template<typename _Tp >
_Tp & cv::SparseMat_< _Tp >::ref ( int i0,
int i1,
int i2,
size_t * hashval = 0 )

equivalent to SparseMat::ref<_Tp>(i0, i1, i2, hashval)

◆ ref() [3/4]

template<typename _Tp >
_Tp & cv::SparseMat_< _Tp >::ref ( int i0,
int i1,
size_t * hashval = 0 )

equivalent to SparseMat::ref<_Tp>(i0, i1, hashval)

◆ ref() [4/4]

template<typename _Tp >
_Tp & cv::SparseMat_< _Tp >::ref ( int i0,
size_t * hashval = 0 )

equivalent to SparseMat::ref<_Tp>(i0, hashval)

◆ type()

template<typename _Tp >
int cv::SparseMat_< _Tp >::type ( ) const

converts sparse matrix to the old-style CvSparseMat. All the elements are copied

returns type of the matrix elements


The documentation for this class was generated from the following file: