/*MC
TSSSP - Explicit strong stability preserving ODE solver
Most hyperbolic conservation laws have exact solutions that are total variation diminishing (TVD) or total variation
bounded (TVB) although these solutions often contain discontinuities. Spatial discretizations such as Godunov's
scheme and high-resolution finite volume methods (TVD limiters, ENO/WENO) are designed to preserve these properties,
but they are usually formulated using a forward Euler time discretization or by coupling the space and time
discretization as in the classical Lax-Wendroff scheme. When the space and time discretization is coupled, it is very
difficult to produce schemes with high temporal accuracy while preserving TVD properties. An alternative is the
semidiscrete formulation where we choose a spatial discretization that is TVD with forward Euler and then choose a
time discretization that preserves the TVD property. Such integrators are called strong stability preserving (SSP).
Let c_eff be the minimum number of function evaluations required to step as far as one step of forward Euler while
still being SSP. Some theoretical bounds
1. There are no explicit methods with c_eff > 1.
2. There are no explicit methods beyond order 4 (for nonlinear problems) and c_eff > 0.
3. There are no implicit methods with order greater than 1 and c_eff > 2.
This integrator provides Runge-Kutta methods of order 2, 3, and 4 with maximal values of c_eff. More stages allows
for larger values of c_eff which improves efficiency. These implementations are low-memory and only use 2 or 3 work
vectors regardless of the total number of stages, so e.g. 25-stage 3rd order methods may be an excellent choice.
Methods can be chosen with -ts_ssp_type {rks2,rks3,rk104}
rks2: Second order methods with any number s>1 of stages. c_eff = (s-1)/s
rks3: Third order methods with s=n^2 stages, n>1. c_eff = (s-n)/s
rk104: A 10-stage fourth order method. c_eff = 0.6
Level: beginner
References:
+ 1. - Ketcheson, Highly efficient strong stability preserving Runge Kutta methods with low storage implementations, SISC, 2008.
- 2. - Gottlieb, Ketcheson, and Shu, High order strong stability preserving time discretizations, J Scientific Computing, 2009.
.seealso: TSCreate(), TS, TSSetType()
M*/
PETSC_EXTERN PetscErrorCode TSCreate_SSP(TS ts)
{
TS_SSP *ssp;
PetscErrorCode ierr;
PetscFunctionBegin;
ierr = TSSSPInitializePackage();CHKERRQ(ierr);
ts->ops->setup = TSSetUp_SSP;
ts->ops->step = TSStep_SSP;
ts->ops->reset = TSReset_SSP;
ts->ops->destroy = TSDestroy_SSP;
ts->ops->setfromoptions = TSSetFromOptions_SSP;
ts->ops->view = TSView_SSP;
ierr = PetscNewLog(ts,&ssp);CHKERRQ(ierr);
ts->data = (void*)ssp;
ierr = PetscObjectComposeFunction((PetscObject)ts,"TSSSPGetType_C",TSSSPGetType_SSP);CHKERRQ(ierr);
ierr = PetscObjectComposeFunction((PetscObject)ts,"TSSSPSetType_C",TSSSPSetType_SSP);CHKERRQ(ierr);
ierr = PetscObjectComposeFunction((PetscObject)ts,"TSSSPGetNumStages_C",TSSSPGetNumStages_SSP);CHKERRQ(ierr);
ierr = PetscObjectComposeFunction((PetscObject)ts,"TSSSPSetNumStages_C",TSSSPSetNumStages_SSP);CHKERRQ(ierr);
ierr = TSSSPSetType(ts,TSSSPRKS2);CHKERRQ(ierr);
ssp->nstages = 5;
PetscFunctionReturn(0);
}
/*@C
TSInitializePackage - This function initializes everything in the TS package. It is called
from PetscDLLibraryRegister() when using dynamic libraries, and on the first call to TSCreate()
when using static libraries.
Level: developer
.keywords: TS, initialize, package
.seealso: PetscInitialize()
@*/
PetscErrorCode TSInitializePackage(void)
{
char logList[256];
char *className;
PetscBool opt;
PetscErrorCode ierr;
PetscFunctionBegin;
if (TSPackageInitialized) PetscFunctionReturn(0);
TSPackageInitialized = PETSC_TRUE;
/* Inialize subpackages */
ierr = TSGLLEInitializePackage();CHKERRQ(ierr);
ierr = TSRKInitializePackage();CHKERRQ(ierr);
ierr = TSGLEEInitializePackage();CHKERRQ(ierr);
ierr = TSARKIMEXInitializePackage();CHKERRQ(ierr);
ierr = TSRosWInitializePackage();CHKERRQ(ierr);
ierr = TSSSPInitializePackage();CHKERRQ(ierr);
ierr = TSAdaptInitializePackage();CHKERRQ(ierr);
ierr = TSGLLEAdaptInitializePackage();CHKERRQ(ierr);
/* Register Classes */
ierr = PetscClassIdRegister("TS",&TS_CLASSID);CHKERRQ(ierr);
ierr = PetscClassIdRegister("DMTS",&DMTS_CLASSID);CHKERRQ(ierr);
ierr = PetscClassIdRegister("TSTrajectory",&TSTRAJECTORY_CLASSID);CHKERRQ(ierr);
/* Register Constructors */
ierr = TSRegisterAll();CHKERRQ(ierr);
ierr = TSTrajectoryRegisterAll();CHKERRQ(ierr);
/* Register Events */
ierr = PetscLogEventRegister("TSAdjointStep",TS_CLASSID,&TS_AdjointStep);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSTrajSet",TSTRAJECTORY_CLASSID,&TSTrajectory_Set);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSTrajGet",TSTRAJECTORY_CLASSID,&TSTrajectory_Get);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSTrajDiskWrite",TS_CLASSID,&TSTrajectory_DiskWrite);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSTrajDiskRead",TS_CLASSID,&TSTrajectory_DiskRead);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSStep",TS_CLASSID,&TS_Step);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSPseudoCmptTStp",TS_CLASSID,&TS_PseudoComputeTimeStep);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSFunctionEval",TS_CLASSID,&TS_FunctionEval);CHKERRQ(ierr);
ierr = PetscLogEventRegister("TSJacobianEval",TS_CLASSID,&TS_JacobianEval);CHKERRQ(ierr);
/* Process info exclusions */
ierr = PetscOptionsGetString(NULL,NULL, "-info_exclude", logList, 256, &opt);CHKERRQ(ierr);
if (opt) {
ierr = PetscStrstr(logList, "ts", &className);CHKERRQ(ierr);
if (className) {
ierr = PetscInfoDeactivateClass(TS_CLASSID);CHKERRQ(ierr);
}
}
/* Process summary exclusions */
ierr = PetscOptionsGetString(NULL,NULL, "-log_exclude", logList, 256, &opt);CHKERRQ(ierr);
if (opt) {
ierr = PetscStrstr(logList, "ts", &className);CHKERRQ(ierr);
if (className) {
ierr = PetscLogEventDeactivateClass(TS_CLASSID);CHKERRQ(ierr);
}
}
ierr = PetscRegisterFinalize(TSFinalizePackage);CHKERRQ(ierr);
PetscFunctionReturn(0);
}
