petsc-3.14.6 2021-03-30
Report Typos and Errors

SNESLineSearchSetDamping

Sets the line search damping parameter.

Synopsis

#include "petscsnes.h" 
PetscErrorCode  SNESLineSearchSetDamping(SNESLineSearch linesearch,PetscReal damping)

Input Parameters

linesearch - linesearch context
damping - The damping parameter

Options Database

-snes_linesearch_damping-

Notes

The basic line search merely takes the update step scaled by the damping parameter. The use of the damping parameter in the l2 and cp line searches is much more subtle; it is used as a starting point in calculating the secant step. However, the eventual step may be of greater length than the damping parameter. In the bt line search it is used as the maximum possible step length, as the bt line search only backtracks.

See Also

SNESLineSearchGetDamping()

Level

intermediate

Location

src/snes/linesearch/interface/linesearch.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages