linbox
Data Structures | Public Member Functions | Protected Member Functions
ZeroOne< _Field > Class Template Reference

Time and space efficient representation of sparse {0,1}-matrices. More...

#include <zo.h>

Inherits BlackboxInterface, and BlackboxInterface.

Data Structures

class  IndexIterator
 IndexIterator. More...
 
class  Iterator
 Raw iterator. More...
 

Public Member Functions

template<class OutVector , class InVector >
OutVector & apply (OutVector &y, const InVector &x) const
 apply. More...
 
template<class OutVector , class InVector >
OutVector & applyTranspose (OutVector &y, const InVector &x) const
 applyTranspose. More...
 
std::istream & read (std::istream &is)
 Read the matrix from a stream in the JGD's SMS format. More...
 
 ZeroOne (Field &F, Index *rowP, Index *colP, Index rows, Index cols, Index NNz)
 The real constructor /todo give docs here assuming entries are sorted in lexicographic order by (row,col) pair.
 
template<class OutVector , class InVector >
OutVector & apply (OutVector &y, const InVector &x) const
 Uses one of the three private utility functions. More...
 
template<class OutVector , class InVector >
OutVector & applyTranspose (OutVector &y, const InVector &x) const
 Uses one of the three private utility functions, in the manner described above. More...
 
std::istream & read (std::istream &is)
 Read the matrix from a stream in the JGD's SMS format. More...
 

Protected Member Functions

void rowSort () const
 Tells the number of nonzero entries. More...
 

Detailed Description

template<class _Field>
class LinBox::ZeroOne< _Field >

Time and space efficient representation of sparse {0,1}-matrices.

A 0-1 matrix is a matrix with all 0's and 1's as entries. We're using a NAG-sparse format. Applies can be performed fast, using only additions. When initalizing this class, you only need to build 2 arrays of equal length: an array of the row indices for the non-zero (1's) entries, and an array of the column indices for the non-zero (1's) entries.

A {0, 1,-1} matrix can be effecively represented as the Dif of two ZeroOne's.

A 0-1 matrix is a matrix with all 0's and 1's as entries. We're using a comp-col or comp-row format. That is we have an array of col indices and an array of pointers indicating where the col indices for each row begins within the col index array. (or vice versa if we have sorted by columns.

Applies can be performed fast, using only additions. When initalizing this class, you only need to build 2 arrays of equal length: an array of the row indices for the non-zero (1's) entries, and an array of the column indices for the non-zero (1's) entries.

A {0, 1,-1} matrix can be effecively represented as the Dif of two ZeroOne's.

Examples:
examples/graph-charpoly.C.

Member Function Documentation

◆ apply() [1/2]

OutVector & apply ( OutVector &  y,
const InVector &  x 
) const
inline

apply.

Uses one of the three private utility functions. It calls the generalized utility function _apply if there is no special ordering, _fyapply if there is C_ordering or _fxapply if there is fortran_ordering

◆ applyTranspose() [1/2]

OutVector & applyTranspose ( OutVector &  y,
const InVector &  x 
) const
inline

applyTranspose.

Uses one of the three private utility functions, in the manner described above. Worthy of note is the fact that applyTranspose works by passing the column positions to the _apply functions as if they were rows, and row positions as if they were columns, as if the matrix had been transposed.

◆ read() [1/2]

std::istream& read ( std::istream &  is)
inline

Read the matrix from a stream in the JGD's SMS format.

Parameters
isInput stream from which to read the matrix
Returns
Reference to input stream

◆ rowSort()

void rowSort ( ) const
protected

Tells the number of nonzero entries.

Non blackbox function.

◆ apply() [2/2]

OutVector& apply ( OutVector &  y,
const InVector &  x 
) const

Uses one of the three private utility functions.

It calls the generalized utility function _apply if there is no special ordering, _fyapply if there is C_ordering or _fxapply if there is fortran_ordering

◆ applyTranspose() [2/2]

OutVector& applyTranspose ( OutVector &  y,
const InVector &  x 
) const

Uses one of the three private utility functions, in the manner described above.

Worthy of note is the fact that applyTranspose works by passing the column positions to the _apply functions as if they were rows, and row positions as if they were columns, as if the matrix had been transposed.

◆ read() [2/2]

std::istream& read ( std::istream &  is)
inline

Read the matrix from a stream in the JGD's SMS format.

Parameters
isInput stream from which to read the matrix
Returns
Reference to input stream

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