Class containing several options for the HSS code and data-structures. More...

#include <HSSOptions.hpp>

Public Types
using	real_t = typename RealType< scalar_t >::value_type

Public Member Functions
void	set_rel_tol (real_t rel_tol)

void	set_abs_tol (real_t abs_tol)

void	set_leaf_size (int leaf_size)

void	set_d0 (int d0)

void	set_dd (int dd)

void	set_p (int p)

void	set_max_rank (int max_rank)

void	set_random_engine (random::RandomEngine random_engine)

void	set_random_distribution (random::RandomDistribution random_distribution)

void	set_compression_algorithm (CompressionAlgorithm a)

void	set_clustering_algorithm (ClusteringAlgorithm a)

void	set_approximate_neighbors (int neighbors)

void	set_ann_iterations (int iters)

void	set_user_defined_random (bool user_defined_random)

void	set_synchronized_compression (bool sync)

void	set_log_ranks (bool log_ranks)

void	set_verbose (bool verbose)

real_t	rel_tol () const

real_t	abs_tol () const

int	leaf_size () const

int	d0 () const

int	dd () const

int	p () const

int	max_rank () const

random::RandomEngine	random_engine () const

random::RandomDistribution	random_distribution () const

CompressionAlgorithm	compression_algorithm () const

ClusteringAlgorithm	clustering_algorithm () const

int	approximate_neighbors () const

int	ann_iterations () const

bool	user_defined_random () const

bool	synchronized_compression () const

bool	log_ranks () const

bool	verbose () const

void	set_from_command_line (int argc, const char const cargv)

void	describe_options () const

Detailed Description

template<typename scalar_t>
class strumpack::HSS::HSSOptions< scalar_t >

Class containing several options for the HSS code and data-structures.

Template Parameters

scalar_t scalar type, can be float, double, std::complex<float> or std::complex<double>. This is used here mainly because tolerances might depend on the precision.

Member Typedef Documentation

◆ real_t

template<typename scalar_t >

using strumpack::HSS::HSSOptions< scalar_t >::real_t = typename RealType<scalar_t>::value_type

real_t is the real type corresponding to the (possibly complex) scalar_t template parameter

Member Function Documentation

◆ abs_tol()

template<typename scalar_t >

real_t strumpack::HSS::HSSOptions< scalar_t >::abs_tol ( ) const

inline

Get the absolute compression tolerance.

Returns: the absolute compression tolerance

See also: set_abs_tol(), set_rel_tol(), rel_tol()

◆ ann_iterations()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::ann_iterations ( ) const

inline

Get the number of iterations used in the approximate nearest neighbors search algorithm used in the HSS compression algorithm for kernel matrices. The algorithm will build iters number of random trees.

Returns: Number of random trees to be build

◆ approximate_neighbors()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::approximate_neighbors ( ) const

inline

Get the number of approximate nearest neighbors used in the HSS compression algorithm for kernel matrices.

Returns: Number of approximate neighbors

◆ clustering_algorithm()

template<typename scalar_t >

ClusteringAlgorithm strumpack::HSS::HSSOptions< scalar_t >::clustering_algorithm ( ) const

inline

Get the clustering algorithm to be used. This is used when constructing an HSS approximation of a kernel matrix.

Returns: clustering algorithm

See also: set_clustering_algorithm

◆ compression_algorithm()

template<typename scalar_t >

CompressionAlgorithm strumpack::HSS::HSSOptions< scalar_t >::compression_algorithm ( ) const

inline

Return which variant of the compression algorithm to use.

Returns: Variant of HSS compression algorithm

See also: set_compression_algorithm

◆ d0()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::d0 ( ) const

inline

Get the initial number of random vector that will be used in adaptive randomized HSS compression. See the manual for more info.

Returns: initial guess for the rank, used in adaptive compression

See also: set_d0(), set_dd(), set_p()

◆ dd()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::dd ( ) const

inline

Increment for the number of random vectors during adaptive compression.

Returns: amount with which the number of random vectors will be incremented

See also: set_d0(), set_dd()

◆ describe_options()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::describe_options ( ) const

Print an overview of the available command line options and their current values.

◆ leaf_size()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::leaf_size ( ) const

inline

Get the HSS leaf size.

Returns: the (approximate) HSS leaf size

See also: set_leaf_size()

◆ log_ranks()

template<typename scalar_t >

bool strumpack::HSS::HSSOptions< scalar_t >::log_ranks ( ) const

inline

Check if the ranks should be printed to a log file. NOT supported currently

Returns: True is the ranks should be printed to a log file, else False.

See also: set_log_ranks

◆ max_rank()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::max_rank ( ) const

inline

Get the maximum allowable rank (note, this is not the actual maximum computed rank).

Returns: maximum allowable rank

See also: set_max_rank()

◆ p()

template<typename scalar_t >

int strumpack::HSS::HSSOptions< scalar_t >::p ( ) const

inline

Get the current value of the oversampling parameter.

Returns: the oversampling parameter.

See also: set_p()

◆ random_distribution()

template<typename scalar_t >

random::RandomDistribution strumpack::HSS::HSSOptions< scalar_t >::random_distribution ( ) const

inline

Return the type of random distribution to use in the random sampling HSS construction.

Returns: random distribution

See also: set_random_distribution

◆ random_engine()

template<typename scalar_t >

random::RandomEngine strumpack::HSS::HSSOptions< scalar_t >::random_engine ( ) const

inline

Return the type of random engine to use.

Returns: random engine

See also: set_random_engine

◆ rel_tol()

template<typename scalar_t >

real_t strumpack::HSS::HSSOptions< scalar_t >::rel_tol ( ) const

inline

Get the relative compression tolerance.

Returns: the relative compression tolerance

See also: set_rel_tol(), set_abs_tol(), get_abs_tol()

◆ set_abs_tol()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_abs_tol ( real_t abs_tol )

inline

Set the absolute compression tolerance.

Parameters

abs_tol absolute compression tolerance

◆ set_ann_iterations()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_ann_iterations ( int iters )

inline

Set the number of iterations used in the approximate nearest neighbors search algorithm used in the HSS compression algorithm for kernel matrices. The algorithm will build iters number of random trees.

Parameters

iters Number of random trees to be build

◆ set_approximate_neighbors()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_approximate_neighbors ( int neighbors )

inline

Set the number of approximate nearest neighbors used in the HSS compression algorithm for kernel matrices.

Parameters

neighbors Number of approximate neighbors

◆ set_clustering_algorithm()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_clustering_algorithm ( ClusteringAlgorithm a )

inline

Specify the clustering algorithm. This is used when constructing a kernel matrix approximation.

Parameters

a	Clustering algorithm.

◆ set_compression_algorithm()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_compression_algorithm ( CompressionAlgorithm a )

inline

Specify the variant of the adaptive compression algorithm. See the manual for more information.

Parameters

a	Type of (adaptive) compression scheme

◆ set_d0()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_d0 ( int d0 )

inline

Set the initial number of random samples to be used in the random sampling HSS construction algorithm. See the manual for more information on the randomized compression algorithm.

◆ set_dd()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_dd ( int dd )

inline

Set the number of random to be used to increment the random samples vectors in the adaptive randomized HSS compression algorithm. This is only used when compression_algorithm() == CompressionAlgorithm::STABLE. See the manual for more information on the randomized compression algorithm.

◆ set_from_command_line()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_from_command_line	(	int	argc,
		const char const	cargv
	)

Parse the command line options given by argc and argv. The options will not be modified. Run with –help to see an overview of available options, or call describe_options().

Parameters

argc	Number of elements in argv
argv	Array with options

◆ set_leaf_size()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_leaf_size ( int leaf_size )

inline

Set the HSS leaf size. The smallest diagonal blocks in the HSS hierarchy will have size approximately the leaf size (within a factor 2).

Parameters

leaf_size

◆ set_log_ranks()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_log_ranks ( bool log_ranks )

inline

Log the HSS ranks to a file. TODO is this currently supported??

◆ set_max_rank()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_max_rank ( int max_rank )

inline

Set the maximum rank allowed in HSS compression.

◆ set_p()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_p ( int p )

inline

Oversampling parameter. Used in adaptive compression, to check stopping criterion.

◆ set_random_distribution()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_random_distribution ( random::RandomDistribution random_distribution )

inline

Set the random distribution, used in randomized compression.

See also: RandomEngine, RandomDistribution, set_random_engine()

◆ set_random_engine()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_random_engine ( random::RandomEngine random_engine )

inline

Set the random engine, used in randomized compression.

See also: RandomEngine, RandomDistribution, set_random_distribution()

◆ set_rel_tol()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_rel_tol ( real_t rel_tol )

inline

Set the relative tolerance to be used for HSS compression. Tuning this parameter is very important for performance.

Parameters

rel_tol relative compression tolerance

◆ set_synchronized_compression()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_synchronized_compression ( bool sync )

inline

Set this to true if you require communication in the element extraction routine, since in that case the element extraction is collective, and has to be synchronized.

◆ set_user_defined_random()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_user_defined_random ( bool user_defined_random )

inline

Set this to true if you want to manually fill the random sample vectors with random values.

◆ set_verbose()

template<typename scalar_t >

void strumpack::HSS::HSSOptions< scalar_t >::set_verbose ( bool verbose )

inline

Enable or disable verbose output (only by the root process) to stdout.

◆ synchronized_compression()

template<typename scalar_t >

bool strumpack::HSS::HSSOptions< scalar_t >::synchronized_compression ( ) const

inline

Whether or not the synchronize the element extraction routine.

Returns: True if synchronization is required in the element extraction routine, else False.

See also: set_synchromized_compression

◆ user_defined_random()

template<typename scalar_t >

bool strumpack::HSS::HSSOptions< scalar_t >::user_defined_random ( ) const

inline

Will the user define its own random matrices?

Returns: True if the user will fill up the random matrices, used in the random sampling based HSS construcion, him/her-self.

See also: set_user_defined_random

◆ verbose()

template<typename scalar_t >

bool strumpack::HSS::HSSOptions< scalar_t >::verbose ( ) const

inline

Verbose or quiet?

Returns: True if we want output from the HSS algorithms, else False.

See also: set_verbose

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

/home/pieterg/LBL/STRUMPACK/src/HSS/HSSOptions.hpp

Public Types

Public Member Functions

Detailed Description

template<typename scalar_t> class strumpack::HSS::HSSOptions< scalar_t >

Member Typedef Documentation

◆ real_t

Member Function Documentation

◆ abs_tol()

◆ ann_iterations()

◆ approximate_neighbors()

◆ clustering_algorithm()

◆ compression_algorithm()

◆ d0()

◆ dd()

◆ describe_options()

◆ leaf_size()

◆ log_ranks()

◆ max_rank()

◆ p()

◆ random_distribution()

◆ random_engine()

◆ rel_tol()

◆ set_abs_tol()

◆ set_ann_iterations()

◆ set_approximate_neighbors()

◆ set_clustering_algorithm()

◆ set_compression_algorithm()

◆ set_d0()

◆ set_dd()

◆ set_from_command_line()

◆ set_leaf_size()

◆ set_log_ranks()

◆ set_max_rank()

◆ set_p()

◆ set_random_distribution()

◆ set_random_engine()

◆ set_rel_tol()

◆ set_synchronized_compression()

◆ set_user_defined_random()

◆ set_verbose()

◆ synchronized_compression()

◆ user_defined_random()

◆ verbose()

template<typename scalar_t>
class strumpack::HSS::HSSOptions< scalar_t >