DMMGSetSNESLocal

Sets the local user function that defines the nonlinear set of equations that will use the grid hierarchy and (optionally) its derivative. Collective on DMMG

Synopsis

int DMMGSetSNESLocal(DMMG *dmmg,DALocalFunction1 function, DALocalFunction1 jacobian,
DALocalFunction1 ad_function, DALocalFunction1 admf_function);

Input Parameter

dmmg - the context
function - the function that defines the nonlinear system
jacobian - function defines the local part of the Jacobian (not currently supported)
ad_function - the name of the function with an ad_ prefix. This is ignored if ADIC is not installed
admf_function - the name of the function with an ad_ prefix. This is ignored if ADIC is not installed

Options Database Keys

-dmmg_snes_monitor- . -dmmg_jacobian_fd
-dmmg_jacobian_ad- . -dmmg_jacobian_mf_fd_operator
-dmmg_jacobian_mf_fd- . -dmmg_jacobian_mf_ad_operator
-dmmg_jacobian_mf_ad-

Notes

If ADIC or ADIFOR have been installed, this routine can use ADIC or ADIFOR to compute the derivative; however, that function cannot call other functions except those in standard C math libraries.

If ADIC/ADIFOR have not been installed and the Jacobian is not provided, this routine uses finite differencing to approximate the Jacobian.

See Also

DMMGCreate(), DMMGDestroy, DMMGSetSLES(), DMMGSetSNES()

Level:intermediate
Location:
src/snes/utils/damgsnes.c
Index of all SNES routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/snes/examples/tutorials/ex19.c.html
src/snes/examples/tutorials/ex25.c.html
src/snes/examples/tutorials/ex29.c.html