Thyra::DampenedNewtonNonlinearSolver< Scalar > Class Template Reference

Simple dampended Newton solver using a Armijo line search :-). More...

#include <Thyra_DampenedNewtonNonlinearSolver.hpp>

Inheritance diagram for Thyra::DampenedNewtonNonlinearSolver< Scalar >:

[legend]List of all members.

Overridden from ParameterListAcceptor
void	setParameterList (RCP< Teuchos::ParameterList > const &paramList)
RCP< Teuchos::ParameterList >	getNonconstParameterList ()
RCP< Teuchos::ParameterList >	unsetParameterList ()
RCP< const Teuchos::ParameterList >	getParameterList () const
RCP< const Teuchos::ParameterList >	getValidParameters () const
Overridden from NonlinearSolverBase
void	setModel (const RCP< const ModelEvaluator< Scalar > > &model)
RCP< const ModelEvaluator< Scalar > >	getModel () const
SolveStatus< Scalar >	solve (VectorBase< Scalar > *x, const SolveCriteria< Scalar > *solveCriteria, VectorBase< Scalar > *delta)
RCP< const VectorBase< Scalar > >	get_current_x () const
bool	is_W_current () const
RCP< LinearOpWithSolveBase< Scalar > >	get_nonconst_W (const bool forceUpToDate)
RCP< const LinearOpWithSolveBase< Scalar > >	get_W () const
void	set_W_is_current (bool W_is_current)
Public Types
typedef Teuchos::ScalarTraits< Scalar >	ST
typedef ST::magnitudeType	ScalarMag
typedef Teuchos::ScalarTraits< ScalarMag >	SMT
Public Member Functions
	STANDARD_MEMBER_COMPOSITION_MEMBERS (ScalarMag, defaultTol)
	The default solution tolerance.
	STANDARD_MEMBER_COMPOSITION_MEMBERS (int, defaultMaxNewtonIterations)
	The default maximum number of iterations.
	STANDARD_MEMBER_COMPOSITION_MEMBERS (bool, useDampenedLineSearch)
	The default maximum number of iterations.
	STANDARD_MEMBER_COMPOSITION_MEMBERS (Scalar, armijoConstant)
	Set the armijo constant for the line search.
	STANDARD_MEMBER_COMPOSITION_MEMBERS (int, maxLineSearchIterations)
	Set the maximum number of backtracking line search iterations to take.
	DampenedNewtonNonlinearSolver (const ScalarMag defaultTol=1e-2, const int defaultMaxNewtonIterations=1000, const bool useDampenedLineSearch=true, const Scalar armijoConstant=1e-4, const int maxLineSearchIterations=20)
Static Public Member Functions
RCP< const Teuchos::ParameterList >	getValidSolveCriteriaExtraParameters ()

---

Detailed Description

template<class Scalar>
class Thyra::DampenedNewtonNonlinearSolver< Scalar >

Simple dampended Newton solver using a Armijo line search :-).

This class derives from Teuchos::VerboseObject and therefore will send output to *this->getOStream() if !Teuchos::isNull(this->getOStream()). The amount of output sent to *this->getOStream() depends on the verbosity level returned by this->getVerbLevel():

• Teuchos::VERB_DEFAULT: Same as Teuchos::VERB_LOW.
• Teuchos::VERB_NONE: Output nothing
• Teuchos::VERB_LOW: Ouput only two lines of output for each Newton iteration
• Teuchos::VERB_MEDIUM: Output lines for each Newton iteration and line search iteration
• Teuchos::VERB_HIGH: Output more details about the Newton and line search iterations (good for basic debugging)
• Teuchos::VERB_EXTREME: Dump all the matrices and vectors that are computed.

ToDo: Finish documentation.

---

Member Typedef Documentation

template<class Scalar> typedef Teuchos::ScalarTraits<Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::ST

template<class Scalar> typedef ST::magnitudeType Thyra::DampenedNewtonNonlinearSolver< Scalar >::ScalarMag

template<class Scalar> typedef Teuchos::ScalarTraits<ScalarMag> Thyra::DampenedNewtonNonlinearSolver< Scalar >::SMT

---

Constructor & Destructor Documentation

template<class Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::DampenedNewtonNonlinearSolver (  const ScalarMag  defaultTol = 1e-2, const int  defaultMaxNewtonIterations = 1000, const bool  useDampenedLineSearch = true, const Scalar  armijoConstant = 1e-4, const int  maxLineSearchIterations = 20 )

---

Member Function Documentation

template<class Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::STANDARD_MEMBER_COMPOSITION_MEMBERS (  ScalarMag  , defaultTol  )

The default solution tolerance.

template<class Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::STANDARD_MEMBER_COMPOSITION_MEMBERS (  int  , defaultMaxNewtonIterations  )

The default maximum number of iterations.

template<class Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::STANDARD_MEMBER_COMPOSITION_MEMBERS (  bool  , useDampenedLineSearch  )

The default maximum number of iterations.

template<class Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::STANDARD_MEMBER_COMPOSITION_MEMBERS (  Scalar  , armijoConstant  )

Set the armijo constant for the line search.

template<class Scalar> Thyra::DampenedNewtonNonlinearSolver< Scalar >::STANDARD_MEMBER_COMPOSITION_MEMBERS (  int  , maxLineSearchIterations  )

Set the maximum number of backtracking line search iterations to take.

template<class Scalar> RCP< const Teuchos::ParameterList > Thyra::DampenedNewtonNonlinearSolver< Scalar >::getValidSolveCriteriaExtraParameters (   )  [static]

template<class Scalar> void Thyra::DampenedNewtonNonlinearSolver< Scalar >::setParameterList (  RCP< Teuchos::ParameterList > const &  paramList  )

template<class Scalar> RCP< Teuchos::ParameterList > Thyra::DampenedNewtonNonlinearSolver< Scalar >::getNonconstParameterList (   )  [virtual]

Implements Teuchos::ParameterListAcceptor.

template<class Scalar> RCP< Teuchos::ParameterList > Thyra::DampenedNewtonNonlinearSolver< Scalar >::unsetParameterList (   )  [virtual]

Implements Teuchos::ParameterListAcceptor.

template<class Scalar> RCP< const Teuchos::ParameterList > Thyra::DampenedNewtonNonlinearSolver< Scalar >::getParameterList (   )  const [virtual]

Reimplemented from Teuchos::ParameterListAcceptor.

template<class Scalar> RCP< const Teuchos::ParameterList > Thyra::DampenedNewtonNonlinearSolver< Scalar >::getValidParameters (   )  const [virtual]

Reimplemented from Teuchos::ParameterListAcceptor.

template<class Scalar> void Thyra::DampenedNewtonNonlinearSolver< Scalar >::setModel (  const RCP< const ModelEvaluator< Scalar > > &  model  )  [virtual]

Implements Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> RCP< const ModelEvaluator< Scalar > > Thyra::DampenedNewtonNonlinearSolver< Scalar >::getModel (   )  const [virtual]

Implements Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> SolveStatus< Scalar > Thyra::DampenedNewtonNonlinearSolver< Scalar >::solve (  VectorBase< Scalar > *  x, const SolveCriteria< Scalar > *  solveCriteria, VectorBase< Scalar > *  delta )  [virtual]

Implements Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> RCP< const VectorBase< Scalar > > Thyra::DampenedNewtonNonlinearSolver< Scalar >::get_current_x (   )  const [virtual]

Reimplemented from Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> bool Thyra::DampenedNewtonNonlinearSolver< Scalar >::is_W_current (   )  const [virtual]

Reimplemented from Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> RCP< LinearOpWithSolveBase< Scalar > > Thyra::DampenedNewtonNonlinearSolver< Scalar >::get_nonconst_W (  const bool  forceUpToDate  )  [virtual]

Reimplemented from Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> RCP< const LinearOpWithSolveBase< Scalar > > Thyra::DampenedNewtonNonlinearSolver< Scalar >::get_W (   )  const [virtual]

Reimplemented from Thyra::NonlinearSolverBase< Scalar >.

template<class Scalar> void Thyra::DampenedNewtonNonlinearSolver< Scalar >::set_W_is_current (  bool  W_is_current  )  [virtual]

Reimplemented from Thyra::NonlinearSolverBase< Scalar >.

---

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

• Thyra_DampenedNewtonNonlinearSolver.hpp

---