TSMonitorLGCtxCreate#
Creates a TSMonitorLGCtx context for use with TS to monitor the solution process graphically in various ways
Synopsis#
#include "petscts.h"  
PetscErrorCode TSMonitorLGCtxCreate(MPI_Comm comm, const char host[], const char label[], int x, int y, int m, int n, PetscInt howoften, TSMonitorLGCtx *ctx)
Collective
Input Parameters#
- comm - the MPI communicator to use 
- host - the X display to open, or - NULLfor the local machine
- label - the title to put in the title bar 
- x - the x screen coordinates of the upper left coordinate of the window 
- y - the y screen coordinates of the upper left coordinate of the window 
- m - the screen width in pixels 
- n - the screen height in pixels 
- howoften - if positive then determines the frequency of the plotting, if -1 then only at the final time 
Output Parameter#
- ctx - the context 
Options Database Keys#
- -ts_monitor_lg_timestep - automatically sets line graph monitor 
- -ts_monitor_lg_timestep_log - automatically sets line graph monitor 
- -ts_monitor_lg_solution - monitor the solution (or certain values of the solution by calling - TSMonitorLGSetDisplayVariables()or- TSMonitorLGCtxSetDisplayVariables())
- -ts_monitor_lg_error - monitor the error 
- -ts_monitor_lg_ksp_iterations - monitor the number of - KSPiterations needed for each timestep
- -ts_monitor_lg_snes_iterations - monitor the number of - SNESiterations needed for each timestep
- -lg_use_markers <true,false> - mark the data points (at each time step) on the plot; default is true 
Notes#
Pass the context and TSMonitorLGCtxDestroy() to TSMonitorSet() to have the context destroyed when no longer needed.
One can provide a function that transforms the solution before plotting it with TSMonitorLGCtxSetTransform() or TSMonitorLGSetTransform()
Many of the functions that control the monitoring have two forms: TSMonitorLGSet/GetXXXX() and TSMonitorLGCtxSet/GetXXXX() the first take a TS object as the
first argument (if that TS object does not have a TSMonitorLGCtx associated with it the function call is ignored) and the second takes a TSMonitorLGCtx object
as the first argument.
One can control the names displayed for each solution or error variable with TSMonitorLGCtxSetVariableNames() or TSMonitorLGSetVariableNames()
See Also#
TS: Scalable ODE and DAE Solvers, TSMonitorLGTimeStep(), TSMonitorSet(), TSMonitorLGSolution(), TSMonitorLGError(), TSMonitorDefault(), VecView(),
TSMonitorLGCtxSetVariableNames(), TSMonitorLGCtxGetVariableNames(),
TSMonitorLGSetVariableNames(), TSMonitorLGGetVariableNames(), TSMonitorLGSetDisplayVariables(), TSMonitorLGCtxSetDisplayVariables(),
TSMonitorLGCtxSetTransform(), TSMonitorLGSetTransform(), TSMonitorLGSNESIterations(), TSMonitorLGKSPIterations(),
TSMonitorEnvelopeCtxCreate(), TSMonitorEnvelopeGetBounds(), TSMonitorEnvelopeCtxDestroy(), TSMonitorEnvelop()
Level#
intermediate
Location#
Examples#
src/ts/tutorials/extchemfield.c
Index of all TS routines
Table of Contents for all manual pages
Index of all manual pages