Add ES-DG optimized 3S* low-storage RK methods (Al Jahdali et al. 2022)

.typos.toml

@@ -54,6 +54,7 @@ Darmstadt = "Darmstadt"
 "problèmes" = "problèmes"
 problemes = "problemes"  # French word in citation without accent
 Ono = "Ono"  # Hiroshi Ono, author of Ono10/Ono12 RK methods
+Vor = "Vor"  # vorticity-optimized AlJahdaliVor3S* method family (Al Jahdali et al. 2022)
 padd = "padd"  # variable name in analyticless_convergence_tests.jl
 Preprint = "Preprint"
 Nr = "Nr"

docs/src/explicit/LowStorageRK.md

@@ -99,6 +99,22 @@ ParsaniKetchesonDeconinck3S94
 ParsaniKetchesonDeconinck3S184
 ParsaniKetchesonDeconinck3S105
 ParsaniKetchesonDeconinck3S205
+AlJahdaliAdv3S42
+AlJahdaliAdv3S82
+AlJahdaliAdv3S53
+AlJahdaliAdv3S113
+AlJahdaliAdv3S64
+AlJahdaliAdv3S154
+AlJahdaliAdv3S85
+AlJahdaliAdv3S165
+AlJahdaliVor3S42
+AlJahdaliVor3S82
+AlJahdaliVor3S53
+AlJahdaliVor3S113
+AlJahdaliVor3S64
+AlJahdaliVor3S154
+AlJahdaliVor3S85
+AlJahdaliVor3S165
 CKLLSRK43_2
 CKLLSRK54_3C
 CKLLSRK95_4S

lib/OrdinaryDiffEqLowStorageRK/Project.toml

@@ -1,7 +1,7 @@
 name = "OrdinaryDiffEqLowStorageRK"
 uuid = "b0944070-b475-4768-8dec-fb6eb410534d"
 authors = ["ParamThakkar123 <paramthakkar864@gmail.com>"]
-version = "3.2.2"
+version = "3.3.0"
 
 [deps]
 CommonSolve = "38540f10-b2f7-11e9-35d8-d573e4eb0ff2"

lib/OrdinaryDiffEqLowStorageRK/src/OrdinaryDiffEqLowStorageRK.jl

@@ -146,6 +146,10 @@ export ORK256, CarpenterKennedy2N54, SHLDDRK64, DGLDDRK73_C, DGLDDRK84_C,
     ParsaniKetchesonDeconinck3S53, ParsaniKetchesonDeconinck3S173,
     ParsaniKetchesonDeconinck3S94, ParsaniKetchesonDeconinck3S184,
     ParsaniKetchesonDeconinck3S105, ParsaniKetchesonDeconinck3S205,
+    AlJahdaliAdv3S42, AlJahdaliAdv3S82, AlJahdaliAdv3S53, AlJahdaliAdv3S113,
+    AlJahdaliAdv3S64, AlJahdaliAdv3S154, AlJahdaliAdv3S85, AlJahdaliAdv3S165,
+    AlJahdaliVor3S42, AlJahdaliVor3S82, AlJahdaliVor3S53, AlJahdaliVor3S113,
+    AlJahdaliVor3S64, AlJahdaliVor3S154, AlJahdaliVor3S85, AlJahdaliVor3S165,
     RDPK3Sp35, RDPK3SpFSAL35, RDPK3Sp49, RDPK3SpFSAL49, RDPK3Sp510, RDPK3SpFSAL510,
     RK46NL, SHLDDRK_2N, SHLDDRK52
 end

lib/OrdinaryDiffEqLowStorageRK/src/alg_utils.jl

@@ -18,6 +18,22 @@ alg_order(alg::ParsaniKetchesonDeconinck3S94) = 4
 alg_order(alg::ParsaniKetchesonDeconinck3S184) = 4
 alg_order(alg::ParsaniKetchesonDeconinck3S105) = 5
 alg_order(alg::ParsaniKetchesonDeconinck3S205) = 5
+alg_order(alg::AlJahdaliAdv3S42) = 2
+alg_order(alg::AlJahdaliAdv3S82) = 2
+alg_order(alg::AlJahdaliAdv3S53) = 3
+alg_order(alg::AlJahdaliAdv3S113) = 3
+alg_order(alg::AlJahdaliAdv3S64) = 4
+alg_order(alg::AlJahdaliAdv3S154) = 4
+alg_order(alg::AlJahdaliAdv3S85) = 5
+alg_order(alg::AlJahdaliAdv3S165) = 5
+alg_order(alg::AlJahdaliVor3S42) = 2
+alg_order(alg::AlJahdaliVor3S82) = 2
+alg_order(alg::AlJahdaliVor3S53) = 3
+alg_order(alg::AlJahdaliVor3S113) = 3
+alg_order(alg::AlJahdaliVor3S64) = 4
+alg_order(alg::AlJahdaliVor3S154) = 4
+alg_order(alg::AlJahdaliVor3S85) = 5
+alg_order(alg::AlJahdaliVor3S165) = 5
 alg_order(alg::CKLLSRK43_2) = 3
 alg_order(alg::CKLLSRK54_3C) = 4
 alg_order(alg::CKLLSRK95_4S) = 5

lib/OrdinaryDiffEqLowStorageRK/src/algorithms.jl

@@ -331,6 +331,283 @@ Base.@kwdef struct ParsaniKetchesonDeconinck3S205{StageLimiter, StepLimiter, Thr
     thread::Thread = Serial()
 end
 
+# Al Jahdali et al. (2022) 3S* low-storage methods
+# Advection-optimized schemes
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+4-stage, second order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S42",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S42{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+8-stage, second order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S82",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S82{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+5-stage, third order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S53",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S53{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+11-stage, third order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S113",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S113{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+6-stage, fourth order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S64",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S64{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+15-stage, fourth order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S154",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S154{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+8-stage, fifth order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S85",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S85{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+16-stage, fifth order (3S) low-storage scheme, optimized for the 2D advection equation.
+Fixed timestep only.", "AlJahdaliAdv3S165",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliAdv3S165{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+# Vortex-optimized schemes
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+4-stage, second order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S42",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S42{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+8-stage, second order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S82",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S82{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+5-stage, third order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S53",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S53{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+11-stage, third order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S113",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S113{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+6-stage, fourth order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S64",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S64{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+15-stage, fourth order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S154",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S154{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+8-stage, fifth order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S85",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S85{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
+@doc explicit_rk_docstring(
+    "Low-Storage Method
+16-stage, fifth order (3S) low-storage scheme, optimized for the isentropic vortex propagation problem.
+Fixed timestep only.", "AlJahdaliVor3S165",
+    references = "Al Jahdali, Dalcin, Boukharfane, Nolasco, Keyes, Parsani (2022)
+    Optimized explicit Runge-Kutta schemes for high-order collocated discontinuous
+    Galerkin methods for compressible fluid dynamics.
+    Computers & Mathematics with Applications, 118, pp. 27-44.
+    doi: https://doi.org/10.1016/j.camwa.2022.05.006"
+)
+Base.@kwdef struct AlJahdaliVor3S165{StageLimiter, StepLimiter, Thread} <:
+    OrdinaryDiffEqAlgorithm
+    stage_limiter!::StageLimiter = trivial_limiter!
+    step_limiter!::StepLimiter = trivial_limiter!
+    thread::Thread = Serial()
+end
+
 @doc explicit_rk_docstring(
     "Low-Storage Method
 4-stage, third order low-storage scheme, optimized for compressible Navier–Stokes equations.