Main Page | Modules | Class Hierarchy | Alphabetical List | Class List | File List | Class Members | Search for 

AbstractLinAlgPack::MatrixOpNonsingTester Class Reference

Testing class for MatrixOpNonsing interface. More...

#include <AbstractLinAlgPack_MatrixOpNonsingTester.hpp>

List of all members.

Public types

enum  ETestLevel { TEST_LEVEL_2_BLAS = 1, TEST_LEVEL_3_BLAS = 2 }
  More...
enum  EPrintTestLevel { PRINT_NONE = 0, PRINT_BASIC = 1, PRINT_MORE = 2, PRINT_ALL = 3 }
  More...

Set and access options

void test_level (const ETestLevel &test_level)
 Set the level of testing.
void print_tests (const EPrintTestLevel &print_tests)
 Set the level of output produced durring tests.
void dump_all (const bool &dump_all)
 Set whether vectors etc. are printed (warning, this may be a lot of output for larger systems).
void throw_exception (const bool &throw_exception)
 Set whether an exception that is thrown is thrown clear out of the testing function or not.
void num_random_tests (const size_type &num_random_tests)
 Set the number of random test cases created.
void warning_tol (const value_type &warning_tol)
 Set the relative tolerance for numerical tests above which to print a warning.
void error_tol (const value_type &error_tol)
 Set the relative tolerance for numerical tests above which to return false from the testing function.

Constructors / initializers

 MatrixOpNonsingTester (ETestLevel test_level=TEST_LEVEL_2_BLAS, EPrintTestLevel print_tests=PRINT_NONE, bool dump_all=false, bool throw_exception=true, size_type num_random_tests=1, value_type warning_tol=1e-14, value_type error_tol=1e-8)
 Constructor (default options).

Test MatrixOpNonsing

bool test_matrix (const MatrixOpNonsing &M, const char M_name[], std::ostream *out)
 Test a MatrixOpNonsing object.

Detailed Description

Testing class for MatrixOpNonsing interface.

This testing class is basically a unit tester for MatrixOpNonsing. The method test_matrix() runs several different tests to check that $ M M^{-1} \approx I $ and $ M^{-T} M^T \approx I $ using randomly generated vectors v and the methods MatrixNonsing::V_InvMtV() and MatrixOp::Vp_StMtV(). These test should only be performed, of course, on a fully initialized MatrixOpNonsing object.

The tests performed by this testing class are designed to allow some validation for even the larges systems and will produce various levels of output so as to be usefull in debugging.

ToDo: Finish documentation!

Definition at line 51 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

Member Enumeration Documentation

enum AbstractLinAlgPack::MatrixOpNonsingTester::ETestLevel
 

Enumeration values:
TEST_LEVEL_2_BLAS  Test Level-2 BLAS operations only.
TEST_LEVEL_3_BLAS  Test Level-2 and Level-3 BLAS operations.

Definition at line 58 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

enum AbstractLinAlgPack::MatrixOpNonsingTester::EPrintTestLevel
 

Enumeration values:
PRINT_NONE  Don't print anything.
PRINT_BASIC  Print only very basic info.
PRINT_MORE  Print greater detail about the tests.
PRINT_ALL  Print everything all the tests in great detail but output is independent of problem size.

Definition at line 63 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

Constructor & Destructor Documentation

AbstractLinAlgPack::MatrixOpNonsingTester::MatrixOpNonsingTester (  ETestLevel  test_level = TEST_LEVEL_2_BLAS,
EPrintTestLevel  print_tests = PRINT_NONE,
bool  dump_all = false,
bool  throw_exception = true,
size_type  num_random_tests = 1,
value_type  warning_tol = 1e-14,
value_type  error_tol = 1e-8
) 
 

Constructor (default options).

Definition at line 48 of file AbstractLinAlgPack_MatrixOpNonsingTester.cpp.

Member Function Documentation

void AbstractLinAlgPack::MatrixOpNonsingTester::test_level (  const ETestLevel &  test_level  )  [inline]
 

Set the level of testing.

Definition at line 76 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

void AbstractLinAlgPack::MatrixOpNonsingTester::print_tests (  const EPrintTestLevel &  print_tests  )  [inline]
 

Set the level of output produced durring tests.

Definition at line 78 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

void AbstractLinAlgPack::MatrixOpNonsingTester::dump_all (  const bool &  dump_all  )  [inline]
 

Set whether vectors etc. are printed (warning, this may be a lot of output for larger systems).

Definition at line 80 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

void AbstractLinAlgPack::MatrixOpNonsingTester::throw_exception (  const bool &  throw_exception  )  [inline]
 

Set whether an exception that is thrown is thrown clear out of the testing function or not.

Definition at line 82 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

void AbstractLinAlgPack::MatrixOpNonsingTester::num_random_tests (  const size_type &  num_random_tests  )  [inline]
 

Set the number of random test cases created.

Definition at line 84 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

void AbstractLinAlgPack::MatrixOpNonsingTester::warning_tol (  const value_type &  warning_tol  )  [inline]
 

Set the relative tolerance for numerical tests above which to print a warning.

Definition at line 86 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

void AbstractLinAlgPack::MatrixOpNonsingTester::error_tol (  const value_type &  error_tol  )  [inline]
 

Set the relative tolerance for numerical tests above which to return false from the testing function.

Definition at line 88 of file AbstractLinAlgPack_MatrixOpNonsingTester.hpp.

bool AbstractLinAlgPack::MatrixOpNonsingTester::test_matrix (  const MatrixOpNonsing &  M,
const char  M_name[],
std::ostream *  out
) 
 

Test a MatrixOpNonsing object.

Parameters:
M [in] Matrix object being tested.
M_name [in] Name given to the matrix object to be used in outputting and error reporting (i.e. throwing an exception).
out [in/out] If out != NULL any and all output will be sent here. If out == NULL then no output will be produced.
Returns:
Returns true if all of the tests checked out and no unexpected exceptions were thrown.
The behavior of this method depends on a set of options and the input arguments.
  • throw_exception(bool): If throw_exception() == true, then if any of the objects within this function throw exceptions, these exceptions will be be thrown clean out of this function for the caller to handle. If throw_exception() == false, then if any object throws an exception, the exception is caught and this this function will return false. In any case an error message will be printed to *out (if out != NULL</tt) before leaving the function (by return or throw).
  • dump_all(bool): If dump_all() == true then all of the computed quantities will but dumped to out. Note that this is a useful option for initial debugging of small systems but not a good idea for larger systems as it will result in an excessive amount of output.
  • ToDo: Add rest of options!

Definition at line 66 of file AbstractLinAlgPack_MatrixOpNonsingTester.cpp.

The documentation for this class was generated from the following files:
Generated on Thu Sep 18 12:33:54 2008 for AbstractLinAlgPack: C++ Interfaces For Vectors, Matrices And Related Linear Algebra Objects by doxygen 1.3.9.1