HLIBpro  3.0
TMatrixVisBase Class Reference

Implements 2D based matrix visualisation.

#include <TMatrixVis.hh>

Inheritance diagram for TMatrixVisBase:
TPDFMatrixVis TPSMatrixVis

Public Member Functions

 TMatrixVisBase ()
 construct matrix visualisation object
 
void border (const bool b)
 turn on/off printing of matrix block border (default: on)
 
void color (const bool b)
 turn on/off color usage for visualization (default: on)
 
void structure (const bool b)
 turn on/off printing of structure of matrix (default: on)
 
void indexset (const bool b)
 turn on/off printing of indexsets (default: off)
 
void id (const bool b)
 turn on/off printing of id (default: off)
 
void nonempty (const bool b)
 turn on/off printing of only nonempty blocks (default: off)
 
void only_local (const bool b)
 turn on/off printing of local/non-local matrix blocks (default: off)
 
void neighbours (const bool b)
 turn on/off printing of neighbourhood relation (default: off)
 
void entries (const bool b)
 turn on/off printing of matrix coefficients (default: off)
 
void pattern (const bool b)
 turn on/off printing of sparsity pattern (default: off)
 
void sparse_pattern (const bool b)
 turn on/off printing of sparsity pattern of sparse matrices only (default: off)
 
void svd (const bool b)
 turn on/off printing of SVD of matrix-blocks (default: off)
 
void rank_col (const bool b, const size_t max_rank=0, const std::string &cmap="default")
 
void mem_col (const bool b, const std::string &cmap="default")
 turn on/off colouring matrix blocks according to memory consumption (default: off)
 
void max_size_ratio (const double r)
 
void max_level (const size_t l)
 set maximal level in matrix (no blocks on levels below will be printed) (default: 0 [off])
 
void svd_ref (const double ref_max, const double ref_min=Limits::epsilon< double >())
 

Member Function Documentation

◆ max_size_ratio()

void max_size_ratio ( const double  r)

set maximal allowed ratio of block size compared to largest block size (default: 1000); if ratio is exceeded, block will not be printed to limit file size for very large matrices

◆ rank_col()

void rank_col ( const bool  b,
const size_t  max_rank = 0,
const std::string &  cmap = "default" 
)

turn on/off colouring matrix blocks according to rank compared with max_rank (default: off) if max_rank is 0, it is compared with block local maximal rank

◆ svd_ref()

void svd_ref ( const double  ref_max,
const double  ref_min = Limits::epsilon< double >() 
)

set value of largest/smallest singular value to compare with for each block;

  • if ref_max/ref_min 0, the largest/smallest local singular values per block are used
  • good choice for ref_max is ∥A∥₂