Thyra_MLPreconditionerFactory.hpp

/*@HEADER
// ***********************************************************************
// 
//       Ifpack: Object-Oriented Algebraic Preconditioner Package
//                 Copyright (2002) Sandia Corporation
// 
// Under terms of Contract DE-AC04-94AL85000, there is a non-exclusive
// license for use of this work by or on behalf of the U.S. Government.
// 
// This library is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as
// published by the Free Software Foundation; either version 2.1 of the
// License, or (at your option) any later version.
//  
// This library is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//  
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
// USA
// Questions? Contact Michael A. Heroux (maherou@sandia.gov) 
// 
// ***********************************************************************
//@HEADER
*/

#ifndef THYRA_ML_PRECONDITIONER_FACTORY_DECL_HPP
#define THYRA_ML_PRECONDITIONER_FACTORY_DECL_HPP


#include "Thyra_PreconditionerFactoryBase.hpp"
#include "Thyra_EpetraOperatorViewExtractorBase.hpp"
#include "Teuchos_StandardCompositionMacros.hpp"

namespace Thyra {

  using Teuchos::ParameterList;
  using Teuchos::RefCountPtr;

  enum EMLProblemType {ML_SmoothedAggregation, 
                       ML_DomainDecomposition,
                       ML_DomainDecompositionML,
                       ML_Maxwell};

class MLPreconditionerFactory : public PreconditionerFactoryBase<double> {
public:


  MLPreconditionerFactory();

  MLPreconditionerFactory(const RefCountPtr<ParameterList>& params);

  MLPreconditionerFactory(const EMLProblemType& probType,
                          const ParameterList& revisions=ParameterList());

  MLPreconditionerFactory(const std::string& probType,
                          const ParameterList& revisions=ParameterList());
    
  STANDARD_COMPOSITION_MEMBERS( EpetraOperatorViewExtractorBase, epetraFwdOpViewExtractor )

  //@}

  

  bool isCompatible( const LinearOpSourceBase<double> &fwdOp ) const;
  bool applySupportsConj(EConj conj) const;
  bool applyTransposeSupportsConj(EConj conj) const;
  RefCountPtr<PreconditionerBase<double> > createPrec() const;
  void initializePrec(
    const RefCountPtr<const LinearOpSourceBase<double> >    &fwdOp
    ,PreconditionerBase<double>                                *prec
    ,const ESupportSolveUse                                    supportSolveUse
    ) const;
  void uninitializePrec(
    PreconditionerBase<double>                          *prec
    ,RefCountPtr<const LinearOpSourceBase<double> >  *fwdOp
    ,ESupportSolveUse                                   *supportSolveUse
    ) const;



  void setParameterList(RefCountPtr<ParameterList> const& paramList);
  RefCountPtr<ParameterList> getParameterList();
  RefCountPtr<ParameterList> unsetParameterList();
  RefCountPtr<const ParameterList> getParameterList() const;
  RefCountPtr<const Teuchos::ParameterList> getValidParameters() const;


  std::string description() const;


private:

  RefCountPtr<ParameterList> reviseDefaultList(const ParameterList& defaults, 
                                               const ParameterList& revisions) const;

  std::string probToString(const EMLProblemType& probType) const ;

  RefCountPtr<ParameterList> defaultParameters(const EMLProblemType& probType) const ;

  RefCountPtr<ParameterList> defaultParameters(const string& probType) const ;

  // ////////////////////////////////
  // Private data members

  mutable RefCountPtr<ParameterList>  validPL_;
  RefCountPtr<ParameterList>          paramList_;


  // ////////////////////////////////
  // Private member functions

  static RefCountPtr<const ParameterList> generateAndGetValidParameters();

};

} // namespace Thyra

#endif // THYRA_ML_PRECONDITIONER_FACTORY_DECL_HPP

---