petsc-3.7.1 2016-05-15
Report Typos and Errors

TSMonitorSet

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

Synopsis

#include "petscts.h"  
PetscErrorCode  TSMonitorSet(TS ts,PetscErrorCode (*monitor)(TS,PetscInt,PetscReal,Vec,void*),void *mctx,PetscErrorCode (*mdestroy)(void**))
Logically Collective on TS Many br

Input Parameters

ts - the TS context obtained from TSCreate() Many br
monitor - monitoring routine Many br
mctx - [optional] user-defined context for private data for the Many brmonitor routine (use NULL if no context is desired) Many br
monitordestroy - [optional] routine that frees monitor context Many br(may be NULL) Many br

Calling sequence of monitor

   int monitor(TS ts,PetscInt steps,PetscReal time,Vec u,void *mctx)

ts - the TS context Many br
steps - iteration number (after the final time step the monitor routine may be called with a step of -1, this indicates the solution has been interpolated to this time) Many br
time - current time Many br
u - current iterate Many br
mctx - [optional] monitoring context Many br

Notes

This routine adds an additional monitor to the list of monitors that Many bralready has been loaded. Many br

Fortran notes: Only a single monitor function can be set for each TS object Many br

Many br

Keywords

TS, timestep, set, monitor

See Also

TSMonitorDefault(), TSMonitorCancel()

Level:intermediate
Location:
src/ts/interface/ts.c
Index of all TS routines
Table of Contents for all manual pages
Index of all manual pages

Examples

src/ts/examples/tutorials/ex2.c.html
src/ts/examples/tutorials/ex3.c.html
src/ts/examples/tutorials/ex4.c.html
src/ts/examples/tutorials/ex5.c.html
src/ts/examples/tutorials/ex6.c.html
src/ts/examples/tutorials/ex7.c.html
src/ts/examples/tutorials/ex8.c.html
src/ts/examples/tutorials/ex11.c.html
src/ts/examples/tutorials/ex12.c.html
src/ts/examples/tutorials/ex14.c.html
src/ts/examples/tutorials/ex16.c.html