Various convergence tests based on the norm of the change in the solution vector, $ x $ , between outer iterations. More...

#include <NOX_StatusTest_NormUpdate.H>

Inheritance diagram for NOX::StatusTest::NormUpdate:

[legend]

Collaboration diagram for NOX::StatusTest::NormUpdate:

[legend]

Public Types
enum	ScaleType { Unscaled, Scaled }
	Type that determines whether to scale the norm by the problem size. More...

Public Member Functions
	NormUpdate (double tolerance, NOX::Abstract::Vector::NormType ntype, ScaleType stype=Scaled)
	Constructor for absolute norm. More...

	NormUpdate (double tolerance, ScaleType stype=Scaled)
	Constructor for absolute norm. More...

virtual	~NormUpdate ()
	Destructor.

virtual NOX::StatusTest::StatusType	checkStatus (const NOX::Solver::Generic &problem, NOX::StatusTest::CheckType checkType)
	Test the stopping criterion More...

virtual NOX::StatusTest::StatusType	getStatus () const
	Return the result of the most recent checkStatus call.

virtual std::ostream &	print (std::ostream &stream, int indent=0) const
	Output formatted description of stopping test to output stream.


virtual double	getNormUpdate () const
	Returns the value of the Update-norm computed in the last call to checkStatus.

virtual double	getTolerance () const
	Returns the true tolerance.

Public Member Functions inherited from NOX::StatusTest::Generic
	Generic ()
	Constructor.

virtual	~Generic ()
	Destructor.

Detailed Description

Various convergence tests based on the norm of the change in the solution vector, $ x $ , between outer iterations.

If checkStatusEfficiently is called with the type set to NOX::StatusTest::None, then the status is set to NOX::StatusTest::Unevaluated and returned. (Also #normUpdate is set to -1.0.)

If checkStatusEfficiently is called on the first iteration, then the status is set to NOX::StatusTest::Unconverged and returned. (Also #normUpdate is set to -1.0.)

If checkStatusEfficiently is called on a problem where the solution group does not have F evaluated (i.e., problem.getSolutionGroup().isF() is false), then the status is set to NOX::StatusTest::Unconverged and returned. (Also #normUpdate is set to -1.0.)

Finally, we return NOX::StatusTest::Converged if $\alpha < \beta$ and NOX::StatusTest::Uncoverged otherwise. Here $\alpha$ represents the norm of $\Delta x$ and $\beta$ represents the tolerance. We define:

$\Delta x = x_k - x_{k-1}$

where $ x_k $ is the solution vector of the $ k $ -th nonlinear iterate.

Let $\gamma$ denote an optional scale factor defined as

$\gamma = \frac{1}{n}$ if sType in the constructor is NOX::NormF::Scaled, and
$\gamma = 1$ if sType in the constructor is NOX::NormF::Unscaled.

Then $\alpha$ is defined as follows:

If nType in the constructor is Abstract::Vector::TWO, then
$\alpha = \sqrt{ \gamma \sum_{i=1}^n \Delta x_i^2 }$
If nType in the constructor is Abstract::Vector::ONE, then
$\alpha = \gamma \sum_{i=1}^n | \Delta x_i |$
If nType in the constructor is Abstract::Vector::INF, then
$\alpha = \gamma \max_{i} | \Delta x_i |$

Finally, $\beta$ is set to the tolerance in the constructor, i.e.,

$\beta = \mbox{tolerance}$

Member Enumeration Documentation

enum NOX::StatusTest::NormUpdate::ScaleType

Type that determines whether to scale the norm by the problem size.

Enumerator
Unscaled	No norm scaling.
Scaled	Scale the norm by the length of the vector.

Constructor & Destructor Documentation

NormUpdate::NormUpdate	(	double	tolerance,
		NOX::Abstract::Vector::NormType	ntype,
		ScaleType	stype = `Scaled`
	)

Constructor for absolute norm.

This constructor defaults to the Absolute tolerance type.

References NOX::StatusTest::Unevaluated.

NormUpdate::NormUpdate	(	double	tolerance,
		ScaleType	stype = `Scaled`
	)

Constructor for absolute norm.

This constructor defaults to the Absolute ToleranceType and TWO NormType.

Member Function Documentation

StatusType NormUpdate::checkStatus	(	const NOX::Solver::Generic &	problem,
		NOX::StatusTest::CheckType	checkType
	)

virtual

Test the stopping criterion

The test can (and should, if possible) be skipped if checkType is NOX::StatusType::None. If the test is skipped, then the status should be set to NOX::StatusTest::Unevaluated.

Implements NOX::StatusTest::Generic.

References NOX::Abstract::Vector::clone(), NOX::StatusTest::Converged, NOX::Solver::Generic::getNumIterations(), NOX::Solver::Generic::getPreviousSolutionGroup(), NOX::Solver::Generic::getSolutionGroup(), NOX::Abstract::Group::getX(), Teuchos::is_null(), NOX::Abstract::Group::isF(), NOX::Abstract::Vector::length(), NOX::StatusTest::None, NOX::Abstract::Vector::norm(), Scaled, NOX::Abstract::Vector::TwoNorm, NOX::StatusTest::Unconverged, NOX::StatusTest::Unevaluated, and NOX::Abstract::Vector::update().

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

NOX_StatusTest_NormUpdate.H
NOX_StatusTest_NormUpdate.C

Public Types

Public Member Functions

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation