precice::cplscheme::impl::RelativeConvergenceMeasure Class Reference

Measures the convergence from an old data set to a new one. More...

#include <RelativeConvergenceMeasure.hpp>

Inheritance diagram for precice::cplscheme::impl::RelativeConvergenceMeasure:

Collaboration diagram for precice::cplscheme::impl::RelativeConvergenceMeasure:

Public Member Functions
	RelativeConvergenceMeasure (double convergenceLimitPercent)
	Constructor.
virtual	~RelativeConvergenceMeasure ()
virtual void	newMeasurementSeries ()
	To be called when a new meas. series (iteration process) starts.
virtual void	measure (const Eigen::VectorXd &oldValues, const Eigen::VectorXd &newValues)
	Performs convergence measurement.
virtual bool	isConvergence () const
	Returns true, if the last measurement indicates convergence.
virtual std::string	printState (const std::string &dataName)
	Adds current convergence information to output stream.
virtual double	getNormResidual ()
	Returns the l2-norm of the coupling residuum.
virtual std::string	getAbbreviation () const
	Returns an abbreviation of the name of the measure for the log file headers.
Public Member Functions inherited from precice::cplscheme::impl::ConvergenceMeasure
virtual	~ConvergenceMeasure ()
	Destructor, empty.

Private Attributes
logging::Logger	_log {"cplscheme::RelativeConvergenceMeasure"}
double	_convergenceLimitPercent
double	_normDiff = 0
double	_norm = 0
bool	_isConvergence = false

Detailed Description

Measures the convergence from an old data set to a new one.

The convergence is evaluated by looking at the two norm of the differences between each data value from the new and old data set. If the two norm is equal or below a given percentage of the norm of the old data set, convergence is achieved.

For a description of how to perform the measurement, see class ConvergenceMeasure.

Definition at line 41 of file RelativeConvergenceMeasure.hpp.

Constructor & Destructor Documentation

RelativeConvergenceMeasure()

precice::cplscheme::impl::RelativeConvergenceMeasure::RelativeConvergenceMeasure

(

double

convergenceLimitPercent

)

Constructor.

Parameters

[in]

convergenceLimitPercent

Limit to define convergence relative to the norm of the current new dataset. Has to be in $] 0 ; 1 ]$.

Definition at line 6 of file RelativeConvergenceMeasure.cpp.

Here is the call graph for this function:

~RelativeConvergenceMeasure()

virtual precice::cplscheme::impl::RelativeConvergenceMeasure::~RelativeConvergenceMeasure ( )

inlinevirtual

Definition at line 52 of file RelativeConvergenceMeasure.hpp.

Member Function Documentation

getAbbreviation()

virtual std::string precice::cplscheme::impl::RelativeConvergenceMeasure::getAbbreviation ( ) const

inlinevirtual

Returns an abbreviation of the name of the measure for the log file headers.

Reimplemented from precice::cplscheme::impl::ConvergenceMeasure.

Definition at line 107 of file RelativeConvergenceMeasure.hpp.

getNormResidual()

virtual double precice::cplscheme::impl::RelativeConvergenceMeasure::getNormResidual ( )

inlinevirtual

Returns the l2-norm of the coupling residuum.

Reimplemented from precice::cplscheme::impl::ConvergenceMeasure.

Definition at line 99 of file RelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

isConvergence()

virtual bool precice::cplscheme::impl::RelativeConvergenceMeasure::isConvergence ( ) const

inlinevirtual

Returns true, if the last measurement indicates convergence.

Implements precice::cplscheme::impl::ConvergenceMeasure.

Definition at line 75 of file RelativeConvergenceMeasure.hpp.

measure()

virtual void precice::cplscheme::impl::RelativeConvergenceMeasure::measure ( const Eigen::VectorXd & oldValues, const Eigen::VectorXd & newValues )

inlinevirtual

Performs convergence measurement.

Parameters

[in]	oldValues	Old iterate values.
[in]	newValues	New iterate values.

Implements precice::cplscheme::impl::ConvergenceMeasure.

Definition at line 59 of file RelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

newMeasurementSeries()

virtual void precice::cplscheme::impl::RelativeConvergenceMeasure::newMeasurementSeries ( )

inlinevirtual

To be called when a new meas. series (iteration process) starts.

Implements precice::cplscheme::impl::ConvergenceMeasure.

Definition at line 54 of file RelativeConvergenceMeasure.hpp.

printState()

virtual std::string precice::cplscheme::impl::RelativeConvergenceMeasure::printState ( const std::string & dataName )

inlinevirtual

Adds current convergence information to output stream.

Implements precice::cplscheme::impl::ConvergenceMeasure.

Definition at line 83 of file RelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

Member Data Documentation

_convergenceLimitPercent

double precice::cplscheme::impl::RelativeConvergenceMeasure::_convergenceLimitPercent

private

Definition at line 115 of file RelativeConvergenceMeasure.hpp.

_isConvergence

bool precice::cplscheme::impl::RelativeConvergenceMeasure::_isConvergence = false

private

Definition at line 121 of file RelativeConvergenceMeasure.hpp.

_log

logging::Logger precice::cplscheme::impl::RelativeConvergenceMeasure::_log {"cplscheme::RelativeConvergenceMeasure"}

private

Definition at line 113 of file RelativeConvergenceMeasure.hpp.

_norm

double precice::cplscheme::impl::RelativeConvergenceMeasure::_norm = 0

private

Definition at line 119 of file RelativeConvergenceMeasure.hpp.

_normDiff

double precice::cplscheme::impl::RelativeConvergenceMeasure::_normDiff = 0

private

Definition at line 117 of file RelativeConvergenceMeasure.hpp.

---

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

• src/cplscheme/impl/RelativeConvergenceMeasure.hpp
• src/cplscheme/impl/RelativeConvergenceMeasure.cpp