Public Member Functions | Private Member Functions | Private Attributes | List of all members
oomph::GS< CRDoubleMatrix > Class Template Reference

Explicit template specialisation of the Gauss Seidel method for compressed row format matrices. More...

#include <iterative_linear_solver.h>

+ Inheritance diagram for oomph::GS< CRDoubleMatrix >:

Public Member Functions

 GS ()
 Constructor. More...
 
virtual ~GS ()
 Destructor (cleanup storage) More...
 
 GS (const GS &)
 Broken copy constructor. More...
 
void operator= (const GS &)
 Broken assignment operator. More...
 
void smoother_solve (const DoubleVector &rhs, DoubleVector &result)
 The smoother_solve function performs fixed number of iterations on the system A*result=rhs. The number of (smoothing) iterations is the same as the max. number of iterations in the underlying IterativeLinearSolver class. More...
 
void disable_resolve ()
 Overload disable resolve so that it cleans up memory too. More...
 
void smoother_setup (DoubleMatrixBase *matrix_pt)
 Set up the smoother for the matrix specified by the pointer. More...
 
void setup_helper (DoubleMatrixBase *matrix_pt)
 Generic setup function to sort out everything that needs to be set up with regards to the input matrix. More...
 
void solve (Problem *const &problem_pt, DoubleVector &result)
 Solver: Takes pointer to problem and returns the results vector which contains the solution of the linear system defined by the problem's fully assembled Jacobian and residual vector. More...
 
void solve (DoubleMatrixBase *const &matrix_pt, const DoubleVector &rhs, DoubleVector &solution)
 Linear-algebra-type solver: Takes pointer to a matrix and rhs vector and returns the solution of the linear system. More...
 
void solve (DoubleMatrixBase *const &matrix_pt, const Vector< double > &rhs, Vector< double > &result)
 Linear-algebra-type solver: Takes pointer to a matrix and rhs vector and returns the solution of the linear system Call the broken base-class version. If you want this, please implement it. More...
 
void resolve (const DoubleVector &rhs, DoubleVector &result)
 Re-solve the system defined by the last assembled Jacobian and the rhs vector specified here. Solution is returned in the vector result. More...
 
double preconditioner_setup_time () const
 Returns the time taken to set up the preconditioner. More...
 
unsigned iterations () const
 Number of iterations taken. More...
 
- Public Member Functions inherited from oomph::Smoother
 Smoother ()
 Empty constructor. More...
 
virtual ~Smoother ()
 Virtual empty destructor. More...
 
template<typename MATRIX >
void check_validity_of_solve_helper_inputs (MATRIX *const &matrix_pt, const DoubleVector &rhs, DoubleVector &solution, const double &n_dof)
 Self-test to check that all the dimensions of the inputs to solve helper are consistent and everything that needs to be built, is. More...
 
- Public Member Functions inherited from oomph::IterativeLinearSolver
 IterativeLinearSolver ()
 Constructor: Set (default) trivial preconditioner and set defaults for tolerance and max. number of iterations. More...
 
 IterativeLinearSolver (const IterativeLinearSolver &)
 Broken copy constructor. More...
 
void operator= (const IterativeLinearSolver &)
 Broken assignment operator. More...
 
virtual ~IterativeLinearSolver ()
 Destructor (empty) More...
 
Preconditioner *& preconditioner_pt ()
 Access function to preconditioner. More...
 
Preconditioner *const & preconditioner_pt () const
 Access function to preconditioner (const version) More...
 
double & tolerance ()
 Access to convergence tolerance. More...
 
unsigned & max_iter ()
 Access to max. number of iterations. More...
 
void enable_doc_convergence_history ()
 Enable documentation of the convergence history. More...
 
void disable_doc_convergence_history ()
 Disable documentation of the convergence history. More...
 
void open_convergence_history_file_stream (const std::string &file_name, const std::string &zone_title="")
 Write convergence history into file with specified filename (automatically switches on doc). Optional second argument is a string that can be used (as a zone title) to identify what case we're running (e.g. what combination of linear solver and preconditioner or parameter values are used). More...
 
void close_convergence_history_file_stream ()
 Close convergence history output stream. More...
 
double jacobian_setup_time () const
 returns the time taken to assemble the jacobian matrix and residual vector More...
 
double linear_solver_solution_time () const
 return the time taken to solve the linear system More...
 
void enable_setup_preconditioner_before_solve ()
 Setup the preconditioner before the solve. More...
 
void disable_setup_preconditioner_before_solve ()
 Don't set up the preconditioner before the solve. More...
 
void enable_error_after_max_iter ()
 Throw an error if we don't converge within max_iter. More...
 
void disable_error_after_max_iter ()
 Don't throw an error if we don't converge within max_iter (default). More...
 
void enable_iterative_solver_as_preconditioner ()
 
void disable_iterative_solver_as_preconditioner ()
 
- Public Member Functions inherited from oomph::LinearSolver
 LinearSolver ()
 Empty constructor, initialise the member data. More...
 
 LinearSolver (const LinearSolver &dummy)
 Broken copy constructor. More...
 
void operator= (const LinearSolver &)
 Broken assignment operator. More...
 
virtual ~LinearSolver ()
 Empty virtual destructor. More...
 
void enable_doc_time ()
 Enable documentation of solve times. More...
 
void disable_doc_time ()
 Disable documentation of solve times. More...
 
bool is_doc_time_enabled () const
 Is documentation of solve times enabled? More...
 
bool is_resolve_enabled () const
 Boolean flag indicating if resolves are enabled. More...
 
virtual void enable_resolve ()
 Enable resolve (i.e. store matrix and/or LU decomposition, say) Virtual so it can be overloaded to perform additional tasks. More...
 
virtual void enable_computation_of_gradient ()
 function to enable the computation of the gradient required for the globally convergent Newton method More...
 
void disable_computation_of_gradient ()
 function to disable the computation of the gradient required for the globally convergent Newton method More...
 
void reset_gradient ()
 function to reset the size of the gradient before each Newton solve More...
 
void get_gradient (DoubleVector &gradient)
 function to access the gradient, provided it has been computed More...
 
- Public Member Functions inherited from oomph::DistributableLinearAlgebraObject
 DistributableLinearAlgebraObject ()
 Default constructor - create a distribution. More...
 
 DistributableLinearAlgebraObject (const DistributableLinearAlgebraObject &matrix)
 Broken copy constructor. More...
 
void operator= (const DistributableLinearAlgebraObject &)
 Broken assignment operator. More...
 
virtual ~DistributableLinearAlgebraObject ()
 Destructor. More...
 
LinearAlgebraDistributiondistribution_pt () const
 access to the LinearAlgebraDistribution More...
 
unsigned nrow () const
 access function to the number of global rows. More...
 
unsigned nrow_local () const
 access function for the num of local rows on this processor. More...
 
unsigned nrow_local (const unsigned &p) const
 access function for the num of local rows on this processor. More...
 
unsigned first_row () const
 access function for the first row on this processor More...
 
unsigned first_row (const unsigned &p) const
 access function for the first row on this processor More...
 
bool distributed () const
 distribution is serial or distributed More...
 
bool distribution_built () const
 
void build_distribution (const LinearAlgebraDistribution *const dist_pt)
 setup the distribution of this distributable linear algebra object More...
 
void build_distribution (const LinearAlgebraDistribution &dist)
 setup the distribution of this distributable linear algebra object More...
 

Private Member Functions

void solve_helper (DoubleMatrixBase *const &matrix_pt, const DoubleVector &rhs, DoubleVector &solution)
 General interface to solve function. More...
 
void clean_up_memory ()
 Clean up data that's stored for resolve (if any has been stored) More...
 

Private Attributes

CRDoubleMatrixMatrix_pt
 System matrix pointer in the format specified by the template argument. More...
 
unsigned Iterations
 Number of iterations taken. More...
 
bool Resolving
 Boolean flag to indicate if the solve is done in re-solve mode, bypassing setup of matrix and preconditioner. More...
 
bool Matrix_can_be_deleted
 Boolean flag to indicate if the matrix pointed to be Matrix_pt can be deleted. More...
 
Vector< int > Index_of_diagonal_entries
 Vector whose i'th entry contains the index of the last entry below or on the diagonal of the i'th row of the matrix. More...
 

Additional Inherited Members

- Protected Member Functions inherited from oomph::DistributableLinearAlgebraObject
void clear_distribution ()
 clear the distribution of this distributable linear algebra object More...
 
- Protected Attributes inherited from oomph::Smoother
bool Use_as_smoother
 When a derived class object is being used as a smoother in the MG solver (or elsewhere) the residual norm does not need to be calculated because we're simply performing a fixed number of (smoothing) iterations. This boolean is used as a flag to indicate that the IterativeLinearSolver (which this class is by inheritance) is supposed to act in this way. More...
 
- Protected Attributes inherited from oomph::IterativeLinearSolver
bool Doc_convergence_history
 Flag indicating if the convergence history is to be documented. More...
 
std::ofstream Output_file_stream
 Output file stream for convergence history. More...
 
double Tolerance
 Convergence tolerance. More...
 
unsigned Max_iter
 Maximum number of iterations. More...
 
PreconditionerPreconditioner_pt
 Pointer to the preconditioner. More...
 
double Jacobian_setup_time
 Jacobian setup time. More...
 
double Solution_time
 linear solver solution time More...
 
double Preconditioner_setup_time
 Preconditioner setup time. More...
 
bool Setup_preconditioner_before_solve
 indicates whether the preconditioner should be setup before solve. Default = true; More...
 
bool Throw_error_after_max_iter
 Should we throw an error instead of just returning when we hit the max iterations? More...
 
bool Use_iterative_solver_as_preconditioner
 Use the iterative solver as preconditioner. More...
 
bool First_time_solve_when_used_as_preconditioner
 
- Protected Attributes inherited from oomph::LinearSolver
bool Enable_resolve
 Boolean that indicates whether the matrix (or its factors, in the case of direct solver) should be stored so that the resolve function can be used. More...
 
bool Doc_time
 Boolean flag that indicates whether the time taken. More...
 
bool Compute_gradient
 flag that indicates whether the gradient required for the globally convergent Newton method should be computed or not More...
 
bool Gradient_has_been_computed
 flag that indicates whether the gradient was computed or not More...
 
DoubleVector Gradient_for_glob_conv_newton_solve
 DoubleVector storing the gradient for the globally convergent Newton method. More...
 
- Static Protected Attributes inherited from oomph::IterativeLinearSolver
static IdentityPreconditioner Default_preconditioner
 Default preconditioner: The base class for preconditioners is a fully functional (if trivial!) preconditioner. More...
 

Detailed Description

template<>
class oomph::GS< CRDoubleMatrix >

Explicit template specialisation of the Gauss Seidel method for compressed row format matrices.

Definition at line 790 of file iterative_linear_solver.h.

Constructor & Destructor Documentation

oomph::GS< CRDoubleMatrix >::GS ( )
inline

Constructor.

Definition at line 795 of file iterative_linear_solver.h.

virtual oomph::GS< CRDoubleMatrix >::~GS ( )
inlinevirtual

Destructor (cleanup storage)

Definition at line 800 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::clean_up_memory().

oomph::GS< CRDoubleMatrix >::GS ( const GS< CRDoubleMatrix > &  )
inline

Broken copy constructor.

Definition at line 806 of file iterative_linear_solver.h.

References oomph::BrokenCopy::broken_copy().

Member Function Documentation

void oomph::GS< CRDoubleMatrix >::clean_up_memory ( )
inlineprivatevirtual

Clean up data that's stored for resolve (if any has been stored)

Reimplemented from oomph::LinearSolver.

Definition at line 969 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::Matrix_can_be_deleted, and oomph::GS< MATRIX >::Matrix_pt.

void oomph::GS< CRDoubleMatrix >::disable_resolve ( )
inlinevirtual

Overload disable resolve so that it cleans up memory too.

Reimplemented from oomph::LinearSolver.

Definition at line 831 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::clean_up_memory(), and oomph::LinearSolver::disable_resolve().

unsigned oomph::GS< CRDoubleMatrix >::iterations ( ) const
inlinevirtual

Number of iterations taken.

Implements oomph::IterativeLinearSolver.

Definition at line 955 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::Iterations.

void oomph::GS< CRDoubleMatrix >::operator= ( const GS< CRDoubleMatrix > &  )
inline

Broken assignment operator.

Definition at line 812 of file iterative_linear_solver.h.

References oomph::BrokenCopy::broken_assign().

double oomph::GS< CRDoubleMatrix >::preconditioner_setup_time ( ) const
inlinevirtual

Returns the time taken to set up the preconditioner.

Reimplemented from oomph::IterativeLinearSolver.

Definition at line 938 of file iterative_linear_solver.h.

References oomph::Global_string_for_annotation::string().

void oomph::GS< CRDoubleMatrix >::resolve ( const DoubleVector rhs,
DoubleVector result 
)
inlinevirtual

Re-solve the system defined by the last assembled Jacobian and the rhs vector specified here. Solution is returned in the vector result.

Reimplemented from oomph::LinearSolver.

Definition at line 915 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::Matrix_pt, oomph::GS< MATRIX >::Resolving, and oomph::GS< MATRIX >::solve().

void oomph::GS< CRDoubleMatrix >::setup_helper ( DoubleMatrixBase matrix_pt)

Generic setup function to sort out everything that needs to be set up with regards to the input matrix.

Explicit template specialisation of the smoother_setup function for CR matrices. Set up the smoother for the matrix specified by the pointer. This definition of the smoother_setup has the added functionality that it sorts the entries in the given matrix so that the CRDoubleMatrix implementation of the solver can be used.

Definition at line 1463 of file iterative_linear_solver.cc.

References oomph::GS< MATRIX >::Matrix_can_be_deleted, and oomph::GS< MATRIX >::Matrix_pt.

void oomph::GS< CRDoubleMatrix >::smoother_setup ( DoubleMatrixBase matrix_pt)
inlinevirtual

Set up the smoother for the matrix specified by the pointer.

Implements oomph::Smoother.

Definition at line 838 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::Matrix_can_be_deleted.

void oomph::GS< CRDoubleMatrix >::smoother_solve ( const DoubleVector rhs,
DoubleVector result 
)
inlinevirtual

The smoother_solve function performs fixed number of iterations on the system A*result=rhs. The number of (smoothing) iterations is the same as the max. number of iterations in the underlying IterativeLinearSolver class.

Implements oomph::Smoother.

Definition at line 821 of file iterative_linear_solver.h.

References oomph::GS< MATRIX >::Matrix_pt, oomph::GS< MATRIX >::solve_helper(), and oomph::Smoother::Use_as_smoother.

void oomph::GS< CRDoubleMatrix >::solve ( Problem *const &  problem_pt,
DoubleVector result 
)
virtual

Solver: Takes pointer to problem and returns the results vector which contains the solution of the linear system defined by the problem's fully assembled Jacobian and residual vector.

Explicit template specialisation of the solver for CR matrices: Takes pointer to problem and returns the results vector which contains the solution of the linear system defined by the problem's fully assembled Jacobian and residual vector.

Implements oomph::LinearSolver.

Definition at line 1390 of file iterative_linear_solver.cc.

References oomph::DoubleVector::build(), oomph::DistributableLinearAlgebraObject::build_distribution(), oomph::GS< MATRIX >::clean_up_memory(), oomph::Problem::communicator_pt(), oomph::DistributableLinearAlgebraObject::distribution_pt(), oomph::LinearSolver::Doc_time, oomph::LinearSolver::Enable_resolve, oomph::Problem::get_jacobian(), oomph::IterativeLinearSolver::Jacobian_setup_time, oomph::GS< MATRIX >::Matrix_can_be_deleted, oomph::GS< MATRIX >::Matrix_pt, oomph::Problem::ndof(), oomph::oomph_info, oomph::GS< MATRIX >::Resolving, oomph::GS< MATRIX >::solve_helper(), oomph::TimingHelpers::timer(), and oomph::Smoother::Use_as_smoother.

void oomph::GS< CRDoubleMatrix >::solve ( DoubleMatrixBase *const &  matrix_pt,
const DoubleVector rhs,
DoubleVector solution 
)
inlinevirtual
void oomph::GS< CRDoubleMatrix >::solve ( DoubleMatrixBase *const &  matrix_pt,
const Vector< double > &  rhs,
Vector< double > &  result 
)
inlinevirtual

Linear-algebra-type solver: Takes pointer to a matrix and rhs vector and returns the solution of the linear system Call the broken base-class version. If you want this, please implement it.

Reimplemented from oomph::LinearSolver.

Definition at line 905 of file iterative_linear_solver.h.

References oomph::LinearSolver::solve().

void oomph::GS< CRDoubleMatrix >::solve_helper ( DoubleMatrixBase *const &  matrix_pt,
const DoubleVector rhs,
DoubleVector solution 
)
private

Member Data Documentation

Vector<int> oomph::GS< CRDoubleMatrix >::Index_of_diagonal_entries
private

Vector whose i'th entry contains the index of the last entry below or on the diagonal of the i'th row of the matrix.

Definition at line 999 of file iterative_linear_solver.h.

unsigned oomph::GS< CRDoubleMatrix >::Iterations
private

Number of iterations taken.

Definition at line 987 of file iterative_linear_solver.h.

bool oomph::GS< CRDoubleMatrix >::Matrix_can_be_deleted
private

Boolean flag to indicate if the matrix pointed to be Matrix_pt can be deleted.

Definition at line 995 of file iterative_linear_solver.h.

CRDoubleMatrix* oomph::GS< CRDoubleMatrix >::Matrix_pt
private

System matrix pointer in the format specified by the template argument.

Definition at line 984 of file iterative_linear_solver.h.

bool oomph::GS< CRDoubleMatrix >::Resolving
private

Boolean flag to indicate if the solve is done in re-solve mode, bypassing setup of matrix and preconditioner.

Definition at line 991 of file iterative_linear_solver.h.


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