DefaultNonlinearConvergence.C

Go to the documentation of this file.

//* This file is part of the MOOSE framework
//* https://mooseframework.inl.gov
//*
//* All rights reserved, see COPYRIGHT for full restrictions
//* https://github.com/idaholab/moose/blob/master/COPYRIGHT
//*
//* Licensed under LGPL 2.1, please see LICENSE for details
//* https://www.gnu.org/licenses/lgpl-2.1.html
 
// MOOSE includes
#include "DefaultNonlinearConvergence.h"
#include "FEProblemBase.h"
#include "PetscSupport.h"
#include "NonlinearSystemBase.h"
#include "ConvergenceIterationTypes.h"
 
#include "libmesh/system.h"
 
// PETSc includes
#include <petsc.h>
#include <petscmat.h>
#include <petscsnes.h>
 
registerMooseObject("MooseApp", DefaultNonlinearConvergence);
 
InputParameters
DefaultNonlinearConvergence::validParams()
{
  InputParameters params = DefaultConvergenceBase::validParams();
  params += FEProblemSolve::feProblemDefaultConvergenceParams();
 
  params.addPrivateParam<bool>("added_as_default", false);
 
  params.addClassDescription("Default convergence criteria for FEProblem.");
 
  return params;
}
 
DefaultNonlinearConvergence::DefaultNonlinearConvergence(const InputParameters & parameters)
  : DefaultConvergenceBase(parameters),
    _fe_problem(*getCheckedPointerParam<FEProblemBase *>("_fe_problem_base")),
    _nl_abs_div_tol(getSharedExecutionerParam<Real>("nl_abs_div_tol")),
    _nl_rel_div_tol(getSharedExecutionerParam<Real>("nl_div_tol")),
    _div_threshold(std::numeric_limits<Real>::max()),
    _nl_forced_its(getSharedExecutionerParam<unsigned int>("nl_forced_its")),
    _nl_max_pingpong(getSharedExecutionerParam<unsigned int>("n_max_nonlinear_pingpong")),
    _nl_current_pingpong(0),
    _nl_max_its(getSharedExecutionerParam<unsigned int>("nl_max_its")),
    _nl_abs_tol(getSharedExecutionerParam<Real>("nl_abs_tol")),
    _nl_rel_tol(getSharedExecutionerParam<Real>("nl_rel_tol"))
{
}
 
void
DefaultNonlinearConvergence::initialSetup()
{
  DefaultConvergenceBase::initialSetup();
 
  // This method is also called in preSolve(), which will overwrite the parameters set here.
  // It needs to be called here to collect the names of any duplicate parameters for the
  // checkDuplicateSetSharedExecutionerParams() check. It needs to be called in preSolve()
  // because it needs to know the current nonlinear system; Convergence objects do not know
  // their "associated" nonlinear system (and they could in fact have multiple).
  setNonlinearSystemParameters();
}
 
void
DefaultNonlinearConvergence::checkIterationType(IterationType it_type) const
{
  DefaultConvergenceBase::checkIterationType(it_type);
 
  if (it_type != ConvergenceIterationTypes::NONLINEAR)
    mooseError("DefaultNonlinearConvergence can only be used with nonlinear solves.");
}
 
void
DefaultNonlinearConvergence::preSolve()
{
  DefaultConvergenceBase::preSolve();
 
  setNonlinearSystemParameters();
}
 
void
DefaultNonlinearConvergence::setNonlinearSystemParameters()
{
  NonlinearSystemBase & nl_sys = _fe_problem.currentNonlinearSystem();
 
  auto & params = nl_sys.system().parameters;
  params.set<unsigned int>("nonlinear solver maximum iterations") = _nl_max_its;
  params.set<unsigned int>("nonlinear solver maximum function evaluations") =
      getSharedExecutionerParam<unsigned int>("nl_max_funcs");
  params.set<Real>("nonlinear solver absolute residual tolerance") = _nl_abs_tol;
  params.set<Real>("nonlinear solver relative residual tolerance") = _nl_rel_tol;
  params.set<Real>("nonlinear solver divergence tolerance") =
      getSharedExecutionerParam<Real>("nl_div_tol");
  params.set<Real>("nonlinear solver absolute step tolerance") =
      getSharedExecutionerParam<Real>("nl_abs_step_tol");
  params.set<Real>("nonlinear solver relative step tolerance") =
      getSharedExecutionerParam<Real>("nl_rel_step_tol");
}
 
NonlinearSystemBase &
DefaultNonlinearConvergence::nonlinearSystem()
{
  return _fe_problem.currentNonlinearSystem();
}
 
bool
DefaultNonlinearConvergence::checkResidualConvergence(const unsigned int n_iter,
                                                      const Real fnorm,
                                                      const Real ref_norm,
                                                      const Real rel_tol,
                                                      const Real abs_tol,
                                                      std::ostringstream & oss)
{
  if (fnorm < abs_tol)
  {
    oss << "Converged due to absolute residual " << fnorm << " < absolute tolerance (" << abs_tol
        << ")\n";
    return true;
  }
  else if (n_iter && fnorm <= ref_norm * rel_tol)
  {
    oss << "Converged due to relative/normalized residual norm " << fnorm / ref_norm
        << " < relative tolerance (" << rel_tol << ")\n";
    return true;
  }
  else
    return false;
}
 
Convergence::MooseConvergenceStatus
DefaultNonlinearConvergence::checkConvergence(unsigned int n_iter)
{
  TIME_SECTION(_perfid_check_convergence);
 
  NonlinearSystemBase & system = nonlinearSystem();
  MooseConvergenceStatus status = MooseConvergenceStatus::ITERATING;
 
  SNES snes = system.getSNES();
 
  // ||u||
  PetscReal xnorm;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetSolutionNorm(snes, &xnorm));
 
  // ||r||
  PetscReal fnorm;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetFunctionNorm(snes, &fnorm));
 
  // ||du||
  PetscReal snorm;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetUpdateNorm(snes, &snorm));
 
  // Get current number of function evaluations done by SNES
  PetscInt nfuncs;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetNumberFunctionEvals(snes, &nfuncs));
 
  // Get tolerances from SNES
  PetscReal abs_tol, rel_tol, rel_step_tol;
  PetscInt max_its, max_funcs;
  LibmeshPetscCallA(
      _fe_problem.comm().get(),
      SNESGetTolerances(snes, &abs_tol, &rel_tol, &rel_step_tol, &max_its, &max_funcs));
 
#if !PETSC_VERSION_LESS_THAN(3, 8, 4)
  PetscBool force_iteration = PETSC_FALSE;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetForceIteration(snes, &force_iteration));
 
  // if PETSc says to force iteration, then force at least one iteration
  if (force_iteration && !(_nl_forced_its))
    _nl_forced_its = 1;
 
  // if specified here to force iteration, but PETSc doesn't know, tell it
  if (!force_iteration && (_nl_forced_its))
  {
    LibmeshPetscCallA(_fe_problem.comm().get(), SNESSetForceIteration(snes, PETSC_TRUE));
  }
#endif
 
  // See if SNESSetFunctionDomainError() has been called.
  // Note: SNESSetFunctionDomainError() and SNESGetFunctionDomainError() were added
  // in different releases of PETSc. The latter was removed in PETSc 3.25.0.
#if PETSC_VERSION_LESS_THAN(3, 25, 0)
  PetscBool domainerror;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetFunctionDomainError(snes, &domainerror));
  if (domainerror)
    status = MooseConvergenceStatus::DIVERGED;
#else
  SNESConvergedReason reason;
  LibmeshPetscCallA(_fe_problem.comm().get(), SNESGetConvergedReason(snes, &reason));
  if (reason == SNES_DIVERGED_FUNCTION_DOMAIN)
    status = MooseConvergenceStatus::DIVERGED;
#endif
 
  // Needed by ResidualReferenceConvergence
  nonlinearConvergenceSetup();
 
  Real fnorm_old;
  // This is the first residual before any iterations have been done, but after
  // solution-modifying objects (if any) have been imposed on the solution vector.
  // We save it, and use it to detect convergence if system.usePreSMOResidual() == false.
  if (n_iter == 0)
  {
    system.setInitialResidual(fnorm);
    fnorm_old = fnorm;
    _nl_current_pingpong = 0;
  }
  else
    fnorm_old = system._last_nl_rnorm;
 
  // Check for nonlinear residual ping-pong.
  // Ping-pong will always start from a residual increase
  if ((_nl_current_pingpong % 2 == 1 && !(fnorm > fnorm_old)) ||
      (_nl_current_pingpong % 2 == 0 && fnorm > fnorm_old))
    _nl_current_pingpong += 1;
  else
    _nl_current_pingpong = 0;
 
  const auto ref_residual = system.referenceResidual();
  std::ostringstream oss;
  if (n_iter < _nl_forced_its)
    oss << "Number of forced iterations not yet reached: " << n_iter << " < " << _nl_forced_its
        << '\n';
  else if (fnorm != fnorm)
  {
    oss << "Failed to converge, residual norm is NaN\n";
    status = MooseConvergenceStatus::DIVERGED;
  }
  else if (checkResidualConvergence(n_iter, fnorm, ref_residual, rel_tol, abs_tol, oss))
    status = MooseConvergenceStatus::CONVERGED;
  else if (nfuncs >= max_funcs)
  {
    oss << "Exceeded maximum number of residual evaluations: " << nfuncs << " > " << max_funcs
        << '\n';
    status = MooseConvergenceStatus::DIVERGED;
  }
  else if ((n_iter >= _nl_forced_its) && n_iter && fnorm > system._last_nl_rnorm &&
           fnorm >= _div_threshold)
  {
    oss << "Nonlinear solve was blowing up!\n";
    status = MooseConvergenceStatus::DIVERGED;
  }
  else if (snorm < rel_step_tol * xnorm)
  {
    oss << "Converged due to small update length: " << snorm << " < " << rel_step_tol << " * "
        << xnorm << '\n';
    status = MooseConvergenceStatus::CONVERGED;
  }
  else if (_nl_rel_div_tol > 0 && fnorm > ref_residual * _nl_rel_div_tol)
  {
    oss << "Diverged due to relative residual " << ref_residual << " > divergence tolerance "
        << _nl_rel_div_tol << " * relative residual " << ref_residual << '\n';
    status = MooseConvergenceStatus::DIVERGED;
  }
  else if (_nl_abs_div_tol > 0 && fnorm > _nl_abs_div_tol)
  {
    oss << "Diverged due to residual " << fnorm << " > absolute divergence tolerance "
        << _nl_abs_div_tol << '\n';
    status = MooseConvergenceStatus::DIVERGED;
  }
  else if (_nl_current_pingpong > _nl_max_pingpong)
  {
    oss << "Diverged due to maximum nonlinear residual pingpong achieved" << '\n';
    status = MooseConvergenceStatus::DIVERGED;
  }
 
  system._last_nl_rnorm = fnorm;
  system._current_nl_its = static_cast<unsigned int>(n_iter);
 
  std::string msg;
  msg = oss.str();
  if (_app.multiAppLevel() > 0)
    MooseUtils::indentMessage(_app.name(), msg);
  if (msg.length() > 0)
#if !PETSC_VERSION_LESS_THAN(3, 17, 0)
    LibmeshPetscCallA(_fe_problem.comm().get(), PetscInfo(snes, "%s", msg.c_str()));
#else
    LibmeshPetscCallA(_fe_problem.comm().get(), PetscInfo(snes, msg.c_str()));
#endif
 
  verboseOutput(oss);
 
  return status;
}
 
void
DefaultNonlinearConvergence::setMaximumIterations(const unsigned int max_iter)
{
  _nl_max_its = max_iter;
}
 
void
DefaultNonlinearConvergence::setAbsoluteTolerance(const Real abs_tol)
{
  _nl_abs_tol = abs_tol;
}
 
void
DefaultNonlinearConvergence::setRelativeTolerance(const Real rel_tol)
{
  _nl_rel_tol = rel_tol;
}