petsc-3.3-p7 2013-05-11
SNESSetFunction
Sets the function evaluation routine and function vector for use by the SNES routines in solving systems of nonlinear equations.
Synopsis
#include "petscsnes.h"
#include "petscdmshell.h"
#include "petscsys.h"
PetscErrorCode SNESSetFunction(SNES snes,Vec r,PetscErrorCode (*func)(SNES,Vec,Vec,void*),void *ctx)
Logically Collective on SNES
Input Parameters
| snes | - the SNES context
|
| r | - vector to store function value
|
| func | - function evaluation routine
|
| ctx | - [optional] user-defined context for private data for the
function evaluation routine (may be PETSC_NULL)
|
Calling sequence of func
func (SNES snes,Vec x,Vec f,void *ctx);
| snes | - the SNES context
|
| x | - state at which to evaluate residual
|
| f | - vector to put residual
|
| ctx | - optional user-defined function context
|
Notes
The Newton-like methods typically solve linear systems of the form
f'(x) x = -f(x),
where f'(x) denotes the Jacobian matrix and f(x) is the function.
Keywords
SNES, nonlinear, set, function
See Also
SNESGetFunction(), SNESComputeFunction(), SNESSetJacobian(), SNESSetPicard()
Level:beginner
Location:src/snes/interface/snes.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages
Examples
src/snes/examples/tutorials/ex1.c.html
src/snes/examples/tutorials/ex2.c.html
src/snes/examples/tutorials/ex3.c.html
src/snes/examples/tutorials/ex5.c.html
src/snes/examples/tutorials/ex5s.c.html
src/snes/examples/tutorials/ex6.c.html
src/snes/examples/tutorials/ex10.c.html
src/snes/examples/tutorials/ex12.c.html
src/snes/examples/tutorials/ex14.c.html
src/snes/examples/tutorials/ex18.c.html
src/snes/examples/tutorials/ex20.c.html