petsc-3.5.4 2015-05-23
Report Typos and Errors

TSSetFromOptions

Sets various TS parameters from user options.

Synopsis

#include "petscts.h"  
PetscErrorCode  TSSetFromOptions(TS ts)
Collective on TS

Input Parameter

ts -the TS context obtained from TSCreate()

Options Database Keys

-ts_type <type> - TSEULER, TSBEULER, TSSUNDIALS, TSPSEUDO, TSCN, TSRK, TSTHETA, TSGL, TSSSP
-ts_max_steps maxsteps - maximum number of time-steps to take
-ts_final_time time - maximum time to compute to
-ts_dt dt - initial time step
-ts_exact_final_time <stepover,interpolate,matchstep> whether to stop at the exact given final time and how to compute the solution at that ti,e- . -ts_max_snes_failures <maxfailures> - Maximum number of nonlinear solve failures allowed
-ts_max_reject <maxrejects> - Maximum number of step rejections before step fails
-ts_error_if_step_fails <true,false> - Error if no step succeeds
-ts_rtol <rtol> - relative tolerance for local truncation error
-ts_atol <atol> Absolute tolerance for local truncation error- . -ts_monitor - print information at each timestep
-ts_monitor_lg_timestep - Monitor timestep size graphically
-ts_monitor_lg_solution - Monitor solution graphically
-ts_monitor_lg_error - Monitor error graphically
-ts_monitor_lg_snes_iterations - Monitor number nonlinear iterations for each timestep graphically
-ts_monitor_lg_ksp_iterations - Monitor number nonlinear iterations for each timestep graphically
-ts_monitor_sp_eig - Monitor eigenvalues of linearized operator graphically
-ts_monitor_draw_solution - Monitor solution graphically
-ts_monitor_draw_solution_phase - Monitor solution graphically with phase diagram
-ts_monitor_draw_error - Monitor error graphically
-ts_monitor_solution_binary <filename> - Save each solution to a binary file
-ts_monitor_solution_vtk <filename.vts> - Save each time step to a binary file, use filename-%%03D.vts

Developer Note: We should unify all the -ts_monitor options in the way that -xxx_view has been unified

Keywords

TS, timestep, set, options, database

See Also

TSGetType()

Level:beginner
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/ex1.c.html
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/ex9.c.html
src/ts/examples/tutorials/ex10.c.html
src/ts/examples/tutorials/ex11.c.html