SNESSetObjective#

Sets the objective function minimized by some of the SNES linesearch methods, used instead of the 2-norm of the residual in the line search

Synopsis#

PetscErrorCode SNESSetObjective(SNES snes, SNESObjectiveFn *obj, void *ctx)

Logically Collective

Input Parameters#

  • snes - the SNES context

  • obj - objective evaluation routine; see SNESObjectiveFn for the calling sequence

  • ctx - [optional] user-defined context for private data for the objective evaluation routine (may be NULL)

Note#

Some of the SNESLineSearch methods attempt to minimize a given objective provided by this function to determine a step length.

If not provided then this defaults to the two-norm of the function evaluation (set with SNESSetFunction())

This is not used in the SNESLINESEARCHCP line search.

See Also#

SNES: Nonlinear Solvers, SNES, SNESLineSearch(), SNESGetObjective(), SNESComputeObjective(), SNESSetFunction(), SNESSetJacobian(), SNESObjectiveFn

Level#

intermediate

Location#

src/snes/interface/snesob.c

Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages