Theseus.jl

Theseus.jl provides implicit and implicit-explicit (IMEX) time integration methods that use Ariadne.jl's Newton–Krylov solver internally. All methods implement the DifferentialEquations.jl integrator interface and can be used with ODEProblem (and SplitODEProblem for IMEX).

Nonlinear Implicit Methods

These single-step methods solve one nonlinear system per stage via Newton–Krylov. They accept an ODEProblem and the keyword argument dt (fixed time step).

Theseus.ImplicitEulerType
ImplicitEuler()

The backward (implicit) Euler method: a first-order, single-stage, A-stable, and L-stable nonlinear implicit Runge-Kutta method.

The stage equation is

\[u^{n+1} = u^n + \Delta t \, f(u^{n+1},\, t^{n+1}).\]

Each time step requires solving one nonlinear system via Newton-Krylov.

source
Theseus.ImplicitMidpointType
ImplicitMidpoint()

The implicit midpoint method: a second-order, single-stage, A-stable nonlinear implicit Runge-Kutta method.

The stage equation evaluates $f$ at the midpoint $(u^n + u^{n+1})/2$:

\[u^{n+1} = u^n + \Delta t \, f\!\left(\frac{u^n + u^{n+1}}{2},\; t + \frac{\Delta t}{2}\right).\]

Each time step requires solving one nonlinear system via Newton-Krylov.

source
Theseus.ImplicitTrapezoidType
ImplicitTrapezoid()

The implicit trapezoidal rule (Crank–Nicolson): a second-order, single-stage, A-stable (but not L-stable) nonlinear implicit method.

The update averages the RHS at both endpoints:

\[u^{n+1} = u^n + \frac{\Delta t}{2}\left[f(u^n, t) + f(u^{n+1}, t + \Delta t)\right].\]

Each time step requires solving one nonlinear system via Newton-Krylov.

source
Theseus.TRBDF2Type
TRBDF2

TR-BDF2 based solver after [2]. Using the formula given in [3] eq (1). See [4] for how it relates to implicit RK methods

source

Diagonally Implicit Runge–Kutta (DIRK) Methods

DIRK methods use a lower-triangular Butcher tableau. Each implicit stage requires one Newton–Krylov solve. They accept an ODEProblem.

Theseus.LobattoIIIA2Type
LobattoIIIA2()

A second-order, two-stage, A-stable DIRK method from the general class of Lobatto IIIA methods.

References

See Table (213) on p. 69 for the Butcher tableau.

  • Christopher A. Kennedy and Mark H. Carpenter (2016) Diagonally Implicit Runge–Kutta Methods for Ordinary Differential Equations: A Review. NASA Technical Memorandum NASA/TM-2016-219173, Langley Research Center, Hampton, VA, United States.
source
Theseus.Crouzeix32Type
Crouzeix32()

A third-order, two-stage, A- and L-stable diagonally implicit Runge-Kutta (DIRK) method developed by Nørsett (1974) and Crouzeix (1975). The nodes and weights are the ones of the two-point Gauss–Legendre quadrature. Thus, this method has order four when applied to quadrature problems.

References

See Table 7.2 on p. 207 for the Butcher tableau.

  • Ernst Hairer, Syvert P. Nørsett, and Gerhard Wanner (1993) Solving Ordinary Differential Equations I: Nonstiff Problems. Springer Series in Computational Mathematics, 2nd edition. DOI: 10.1007/978-3-540-78862-1
source
Theseus.DIRK43Type
DIRK43()

A fourth-order, three-stage, A-stable DIRK method.

References

  • D. Fränken and Karlheinz Ochs (2003) Passive Runge–Kutta Methods—Properties, Parametric Representation, and Order Conditions. BIT Numerical Mathematics 43(2):339–361. DOI: 10.1023/A:1026039820006
source
Theseus.CooperSayfy5Type
Theseus.CooperSayfy5()

A fifth-order, five-stage, A-stable DIRK method.

References

  • E. Hairer, G. Wanner. Solving ordinary differential equations II: Stiff and Differential-Algebraic Problems. Springer, 1996. page.101
  • Cooper, G. J., and A. Sayfy. Semiexplicit Runge-Kutta methods for stiff differential equations. Mathematics of Computation 33, no. 146 (1979): 541-556. doi:10.1090/S0025-5718-1979-0521275-1.
source
Theseus.CrouzeixRaviart34Type
Theseus.CrouzeixRaviart34()

A fourth-order, three-stage, L-stable SDIRK method.

References

  • E. Hairer, G. Wanner. Solving ordinary differential equations II: Stiff and Differential-Algebraic Problems. Springer, 1996. page.100
  • M. Crouzeix. Sur l’approximation des équations différentielles opérationnelles linéaires par des méthodes de Runge-Kutta. Thèse d'état, Univ. Paris 6 192pp, 1975.
source
Theseus.HairerWannerSDIRK4Type
Theseus.HairerWannerSDIRK4()

A fourth-order, five-stage, L-stable SDIRK method.

References

  • E. Hairer, G. Wanner. Solving ordinary differential equations II: Stiff and Differential-Algebraic Problems. Springer, 1996. page. 100
source
Theseus.ESDIRK43SA2Type
Theseus.ESDIRK43SA2()

A fourth-order, six-stage, stiffly accurate ESDIRK method with an embedded third-order method for error estimation.

References

See Table 9 on p. 242 for the Butcher tableau.

  • Christopher A. Kennedy and Mark H. Carpenter (2019) Diagonally Implicit Runge–Kutta Methods for stiff ODEs Applied Numerical Mathematics 146:221–244. DOI: 10.1016/j.apnum.2019.07.008
source

Implicit–Explicit (IMEX) Runge–Kutta Methods

IMEX methods split the right-hand side into a stiff part $f_1$ and a non-stiff part $f_2$. They accept a SplitODEProblem(f1!, f2!, u0, tspan).

Type I methods (Pareschi–Russo)

Theseus.SP111Type
Theseus.SP111()

The symplectic Euler method, a first-order, one-stage type I IMEX method combining an explicit and an implicit Euler method.

References

  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
source
Theseus.H222Type
Theseus.H222()

A second-order, two-stage type I IMEX method. The explicit part is strong stability preserving (SSP), the implicit part is A-stable but not L-stable.

References

  • Sebastiano Boscarino, Lorenzo Pareschi, and Giovanni Russo (2025) Implicit-explicit methods for evolutionary partial differential equations. DOI: 10.1137/1.9781611978209
source
Theseus.SSP2222Type
Theseus.SSP2222()

A second-order, two-stage type I IMEX method developed by Pareschi and Russo (2005). The explicit part is strong stability preserving (SSP), the implicit part is L-stable.

References

  • Lorenzo Pareschi and Giovanni Russo (2005) Implicit–Explicit Runge–Kutta schemes and applications to hyperbolic systems with relaxation. Journal of Computational Physics 203(2):469–491. DOI: 10.1007/s10915-004-4636-4
  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
source
Theseus.SSP2322Type
Theseus.SSP2322()

A second-order, three-stage type I IMEX method developed by Pareschi and Russo (2005). The explicit part is strong stability preserving (SSP), the implicit part is stiffly accurate (SA) and thus L-stable.

References

  • Lorenzo Pareschi and Giovanni Russo (2005) Implicit–Explicit Runge–Kutta schemes and applications to hyperbolic systems with relaxation. Journal of Computational Physics 203(2):469–491. DOI: 10.1007/s10915-004-4636-4
source
Theseus.SSP2332Type
Theseus.SSP2332()

A second-order, three-stage type I IMEX method developed by Pareschi and Russo (2005). The explicit part is strong stability preserving (SSP), the implicit part is stiffly accurate (SA) and thus L-stable.

References

  • Lorenzo Pareschi and Giovanni Russo (2005) Implicit–Explicit Runge–Kutta schemes and applications to hyperbolic systems with relaxation. Journal of Computational Physics 203(2):469–491. DOI: 10.1007/s10915-004-4636-4
  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
source
Theseus.SSP3332Type
Theseus.SSP3332()

A second-order, three-stage type I IMEX method developed by Pareschi and Russo (2005). The explicit part is strong stability preserving (SSP) and third-order accurate, the implicit part is L-stable.

References

  • Lorenzo Pareschi and Giovanni Russo (2005) Implicit–Explicit Runge–Kutta schemes and applications to hyperbolic systems with relaxation. Journal of Computational Physics 203(2):469–491. DOI: 10.1007/s10915-004-4636-4
source
Theseus.SSP3433Type
Theseus.SSP3433()

A third-order, four-stage type I IMEX method developed by Pareschi and Russo (2005). The explicit part is strong stability preserving (SSP) and third-order accurate, the implicit part is L-stable.

References

  • Lorenzo Pareschi and Giovanni Russo (2005) Implicit–Explicit Runge–Kutta schemes and applications to hyperbolic systems with relaxation. Journal of Computational Physics 203(2):469–491. DOI: 10.1007/s10915-004-4636-4
  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
source

Type II methods (Ascher–Ruuth–Spiteri and Kennedy–Carpenter)

Theseus.HT222Type
Theseus.HT222()

A second-order, two-stage type II IMEX method. The explicit part is strong stability preserving (SSP), the implicit part is A-stable but not L-stable.

References

  • Sebastiano Boscarino, Lorenzo Pareschi, and Giovanni Russo (2025) Implicit-explicit methods for evolutionary partial differential equations. DOI: 10.1137/1.9781611978209
source
Theseus.ARS111Type
Theseus.ARS111()

A first-order, effectively one-stage, globally stiffly accurate (GSA) type II IMEX method developed by Ascher, Ruuth, and Spiteri (1997).

References

  • Uri M. Ascher, Steven J. Ruuth, and Raymond J Spiteri (1997) Implicit-explicit Runge-Kutta methods for time-dependent partial differential equations. DOI: 10.1016/S0168-9274(97)00056-1
  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
  • Sebastiano Boscarino, Lorenzo Pareschi, and Giovanni Russo (2025) Implicit-explicit methods for evolutionary partial differential equations. DOI: 10.1137/1.9781611978209
source
Theseus.ARS222Type
Theseus.ARS222()

A second-order, effectively two-stage, globally stiffly accurate (GSA) type II IMEX method developed by Ascher, Ruuth, and Spiteri (1997).

References

  • Uri M. Ascher, Steven J. Ruuth, and Raymond J Spiteri (1997) Implicit-explicit Runge-Kutta methods for time-dependent partial differential equations. DOI: 10.1016/S0168-9274(97)00056-1
  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
  • Sebastiano Boscarino, Lorenzo Pareschi, and Giovanni Russo (2025) Implicit-explicit methods for evolutionary partial differential equations. DOI: 10.1137/1.9781611978209
source
Theseus.ARS233Type
Theseus.ARS233()

A third-order, effectively three-stage type II IMEX method developed by Ascher, Ruuth, and Spiteri (1997). The implicit part is A-stable but not L-stable.

References

  • Uri M. Ascher, Steven J. Ruuth, and Raymond J Spiteri (1997) Implicit-explicit Runge-Kutta methods for time-dependent partial differential equations. DOI: 10.1016/S0168-9274(97)00056-1
  • Sebastiano Boscarino, Lorenzo Pareschi, and Giovanni Russo (2025) Implicit-explicit methods for evolutionary partial differential equations. DOI: 10.1137/1.9781611978209
source
Theseus.ARS443Type
Theseus.ARS443()

A third-order, effectively four-stage, globally stiffly accurate (GSA) type II IMEX method developed by Ascher, Ruuth, and Spiteri (1997).

References

  • Uri M. Ascher, Steven J. Ruuth, and Raymond J Spiteri (1997) Implicit-explicit Runge-Kutta methods for time-dependent partial differential equations. DOI: 10.1016/S0168-9274(97)00056-1
  • Sebastiano Boscarino and Giovanni Russo (2024) Asymptotic preserving methods for quasilinear hyperbolic systems with stiff relaxation: a review. DOI: 10.1007/s40324-024-00351-x
  • Sebastiano Boscarino, Lorenzo Pareschi, and Giovanni Russo (2025) Implicit-explicit methods for evolutionary partial differential equations. DOI: 10.1137/1.9781611978209
source
Theseus.KenCarpARK437Type
Theseus.KenCarpARK437()

A fourth-order, seven-stage type II IMEX method developed by Kennedy and Carpenter (2019). The implicit method is A-stable, L-stable, and stiffly accurate.

References

  • Christopher A. Kennedy and Mark H. Carpenter (2019) Higher-order additive Runge–Kutta schemes for ordinary differential equations. Applied Numerical Mathematics 136:183-205. DOI: 10.1016/j.apnum.2018.10.007
source
Theseus.KenCarpARK548Type
Theseus.KenCarpARK548()

A fifth-order, eight-stage type II IMEX method developed by Kennedy and Carpenter (2019). The implicit method is A-stable, L-stable, and stiffly accurate.

References

  • Christopher A. Kennedy and Mark H. Carpenter (2019) Higher-order additive Runge–Kutta schemes for ordinary differential equations. Applied Numerical Mathematics 136:183-205. DOI: 10.1016/j.apnum.2018.10.007
source
Theseus.BHR553G1Type
Theseus.BHR553G1()

A third order, stiffly accurate, L-stable type II IMEX method developed by Boscarino and Russo (2009).

References

  • Sebastiano Boscarino and Giovanni Russo (2009) On a class of uniformly accurate IMEX Runge-Kutta schemes and applications to hyperbolic systems with relaxation [DOI: 10.1137/080713562], (https://doi.org/10.1137/080713562)
source
Theseus.BHR553G2Type
Theseus.BHR553G2()

A third order, stiffly accurate, L-stable type II IMEX method developed by Boscarino and Russo (2009).

References

  • Sebastiano Boscarino and Giovanni Russo (2009) On a class of uniformly accurate IMEX Runge-Kutta schemes and applications to hyperbolic systems with relaxation [DOI: 10.1137/080713562], (https://doi.org/10.1137/080713562)
source

Rosenbrock-W Methods

Rosenbrock-W methods linearise the implicit system and solve one linear system (via a Krylov method) per stage instead of a full Newton solve. The Jacobian approximation makes them W methods: the exact Jacobian is not required. They accept an ODEProblem.

Theseus.SSPKnothType
SSPKnoth()

A three-stage, second-order strong-stability preserving (SSP) Rosenbrock-W method by Knoth and Wolke.

References

  • O. Knoth and R. Wolke (1998) Implicit-explicit coupled multirate methods for reactive flow with stiff chemistry. Atmospheric Environment, 32(3):507–519.
source
Theseus.ROS2Type
ROS2()

A two-stage, second-order Rosenbrock-W method with diagonal parameter $\gamma = (1 + 1/\sqrt{3})/2$.

References

  • Ernst Hairer and Gerhard Wanner (1996) Solving Ordinary Differential Equations II: Stiff and Differential-Algebraic Problems. Springer Series in Computational Mathematics, 2nd edition. DOI: 10.1007/978-3-642-05221-7
source