petsc-3.7.5 2017-01-01
Report Typos and Errors

SNESLineSearchMonitorSet

Sets an ADDITIONAL function that is to be used at every iteration of the nonlinear solver to display the iteration's progress.

Synopsis

#include "petscsnes.h" 
PetscErrorCode  SNESLineSearchMonitorSet(SNESLineSearch ls,PetscErrorCode (*f)(SNESLineSearch,void*),void *mctx,PetscErrorCode (*monitordestroy)(void**))
Logically Collective on SNESLineSearch

Input Parameters

ls - the SNESLineSearch context
f - the monitor function
mctx - [optional] user-defined context for private data for the monitor routine (use NULL if no context is desired)
monitordestroy - [optional] routine that frees monitor context (may be NULL)

Notes

Several different monitoring routines may be set by calling SNESLineSearchMonitorSet() multiple times; all will be called in the order in which they were set.

Fortran notes: Only a single monitor function can be set for each SNESLineSearch object

Keywords

SNESLineSearch, nonlinear, set, monitor

See Also

SNESLineSearchMonitorDefault(), SNESLineSearchMonitorCancel()

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