preCICE v3.2.0
Loading...
Searching...
No Matches
precice::cplscheme::impl::ResidualRelativeConvergenceMeasure Class Reference

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

#include <ResidualRelativeConvergenceMeasure.hpp>

Inheritance diagram for precice::cplscheme::impl::ResidualRelativeConvergenceMeasure:
[legend]
Collaboration diagram for precice::cplscheme::impl::ResidualRelativeConvergenceMeasure:
[legend]

Public Member Functions

 ResidualRelativeConvergenceMeasure (double convergenceLimitPercent)
 Constructor.
 ~ResidualRelativeConvergenceMeasure () override=default
void newMeasurementSeries () override
 To be called when a new meas. series (iteration process) starts.
void measure (const Eigen::VectorXd &oldValues, const Eigen::VectorXd &newValues) override
 Performs convergence measurement.
bool isConvergence () const override
 Returns true, if the last measurement indicates convergence.
std::string printState (const std::string &dataName) override
 Adds current convergence information to output stream.
double getNormResidual () override
 Returns the l2-norm of the coupling residuum.
std::string getAbbreviation () const override
 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 ()=default
 Destructor, empty.

Private Attributes

logging::Logger _log {"cplscheme::ResidualRelativeConvergenceMeasure"}
double _convergenceLimitPercent
bool _isFirstIteration = true
double _normFirstResidual = std::numeric_limits<double>::max()
double _normDiff = 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 28 of file ResidualRelativeConvergenceMeasure.hpp.

Constructor & Destructor Documentation

◆ ResidualRelativeConvergenceMeasure()

precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::ResidualRelativeConvergenceMeasure ( double convergenceLimitPercent)
explicit

Constructor.

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

Definition at line 7 of file ResidualRelativeConvergenceMeasure.cpp.

Here is the call graph for this function:

◆ ~ResidualRelativeConvergenceMeasure()

precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::~ResidualRelativeConvergenceMeasure ( )
overridedefault

Member Function Documentation

◆ getAbbreviation()

std::string precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::getAbbreviation ( ) const
inlineoverridevirtual

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

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

Definition at line 91 of file ResidualRelativeConvergenceMeasure.hpp.

◆ getNormResidual()

double precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::getNormResidual ( )
inlineoverridevirtual

Returns the l2-norm of the coupling residuum.

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

Definition at line 83 of file ResidualRelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

◆ isConvergence()

bool precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::isConvergence ( ) const
inlineoverridevirtual

Returns true, if the last measurement indicates convergence.

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

Definition at line 61 of file ResidualRelativeConvergenceMeasure.hpp.

◆ measure()

void precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::measure ( const Eigen::VectorXd & oldValues,
const Eigen::VectorXd & newValues )
inlineoverridevirtual

Performs convergence measurement.

Parameters
[in]oldValuesOld iterate values.
[in]newValuesNew iterate values.

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

Definition at line 48 of file ResidualRelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

◆ newMeasurementSeries()

void precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::newMeasurementSeries ( )
inlineoverridevirtual

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

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

Definition at line 41 of file ResidualRelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

◆ printState()

std::string precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::printState ( const std::string & dataName)
inlineoverridevirtual

Adds current convergence information to output stream.

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

Definition at line 67 of file ResidualRelativeConvergenceMeasure.hpp.

Here is the call graph for this function:

Member Data Documentation

◆ _convergenceLimitPercent

double precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::_convergenceLimitPercent
private

Definition at line 99 of file ResidualRelativeConvergenceMeasure.hpp.

◆ _isConvergence

bool precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::_isConvergence = false
private

Definition at line 107 of file ResidualRelativeConvergenceMeasure.hpp.

◆ _isFirstIteration

bool precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::_isFirstIteration = true
private

Definition at line 101 of file ResidualRelativeConvergenceMeasure.hpp.

◆ _log

logging::Logger precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::_log {"cplscheme::ResidualRelativeConvergenceMeasure"}
private

Definition at line 97 of file ResidualRelativeConvergenceMeasure.hpp.

◆ _normDiff

double precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::_normDiff = 0
private

Definition at line 105 of file ResidualRelativeConvergenceMeasure.hpp.

◆ _normFirstResidual

double precice::cplscheme::impl::ResidualRelativeConvergenceMeasure::_normFirstResidual = std::numeric_limits<double>::max()
private

Definition at line 103 of file ResidualRelativeConvergenceMeasure.hpp.


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