FVODE: Modern Fortran port of CVODE
Status: early development. See PLAN.md for the conversion plan and progress.
FVODE is a native Modern Fortran translation of the CVODE ODE integrator from SUNDIALS v7.9.0. The goal is a faithful translation: given the same problem and options, FVODE should take exactly the same steps as CVODE. This is checked by comparing step-by-step traces against the C library.
CVODE comes from a long line of Fortran solvers developed at Lawrence Livermore National Laboratory (LLNL):
- GEAR and EPISODE (1970s) were Hindmarsh's and Byrne's early implementations of the Adams and BDF methods, building on Gear's DIFSUB.
- LSODE (part of ODEPACK, 1980s) became the standard Fortran stiff/non-stiff solver.
- VODE (Brown, Byrne and Hindmarsh, 1989) combined EPISODE's
variable-coefficient Adams and BDF methods, written in Nordsieck form, with the
user interface and design of LSODE.
DVODEis its double-precision version. VODPK added Krylov (preconditioned GMRES) linear solvers for large systems. - CVODE (Cohen and Hindmarsh, 1994) rewrote VODE and VODPK in C. It was followed by the parallel PVODE, and both were merged into the SUNDIALS suite in the early 2000s. CVODE has been developed in C ever since. It now has more linear and nonlinear solver options, root finding, constraint handling, projection and more.
FVODE brings CVODE back to Fortran, this time as Modern Fortran with derived types, type-bound procedures, submodules and an fpm build. All of SUNDIALS' improvements since the split are kept.
For the Fortran predecessor itself, see
DVODE, a modernized (Fortran 2008+)
edition of the original DVODE. The two solvers share the same core method, and
the solver comparison test (pixi run solver-comparison) runs them side by side:
for the same tolerance they use essentially the same number of function
evaluations.
Everything runs through pixi:
pixi run build # build the library (fpm)
pixi run test # run the unit tests
pixi run docs # FORD documentation in ./doc
The Robertson chemical kinetics problem, a classic stiff test case, solved with BDF, a Newton iteration and a dense direct linear solver. The Jacobian is approximated by difference quotients.
program robertson
use fvode ! kinds and constants
use fvode_core, only: cvode_solver
use fvode_matrix, only: dense_matrix
use fvode_linsol_direct, only: sun_linsol_dense
implicit none
type(cvode_solver) :: cvode
real(wp) :: y(3), t, tout
integer :: i, flag
y = [1.0_wp, 0.0_wp, 0.0_wp] ! initial condition at t = 0
call cvode%create(CV_BDF, flag) ! BDF method for a stiff problem
call cvode%init(rhs, 0.0_wp, y, flag)
call cvode%sv_tolerances(1.0e-4_wp, [1.0e-8_wp, 1.0e-14_wp, 1.0e-6_wp], flag)
call cvode%set_linear_solver(sun_linsol_dense(3_ip), dense_matrix(3_ip, 3_ip), flag)
tout = 0.4_wp
do i = 1, 6
call cvode%solve(tout, y, t, CV_NORMAL, flag)
if (flag < 0) error stop 'integration failed'
write(*,'(a,es10.3,a,3es14.6)') 't = ', t, ' y =', y
tout = tout * 10.0_wp
end do
write(*,'(a,i0,a,i0)') 'steps: ', cvode%get_num_steps(), &
' rhs evals: ', cvode%get_num_rhs_evals()
call cvode%destroy()
contains
function rhs(me, t, y, ydot) result(retval)
!! Robertson chemical kinetics: ydot = f(t, y)
class(cvode_solver), intent(inout) :: me
real(wp), intent(in) :: t, y(:)
real(wp), intent(out) :: ydot(:)
integer :: retval
ydot(1) = -0.04_wp*y(1) + 1.0e4_wp*y(2)*y(3)
ydot(3) = 3.0e7_wp*y(2)**2
ydot(2) = -ydot(1) - ydot(3)
retval = 0 ! 0 = success
end function rhs
end program robertsonOutput:
t = 4.000E-01 y = 9.851641E-01 3.386242E-05 1.480205E-02
t = 4.000E+00 y = 9.055097E-01 2.240338E-05 9.446793E-02
t = 4.000E+01 y = 7.157956E-01 9.183493E-06 2.841952E-01
t = 4.000E+02 y = 4.505294E-01 3.223044E-06 5.494674E-01
t = 4.000E+03 y = 1.831814E-01 8.940625E-07 8.168177E-01
t = 4.000E+04 y = 3.897848E-02 1.621552E-07 9.610214E-01
steps: 389 rhs evals: 586
To use FVODE in your own fpm project, add it as a dependency in fpm.toml:
[dependencies]
fvode = { git = "https://github.com/jacobwilliams/fvode" }For non-stiff problems, use CV_ADAMS and attach the fixed-point nonlinear
solver instead of a linear solver:
call cvode%set_nonlinear_solver(sun_nonlinsol_fixedpoint(n, 0), flag) from
fvode_nonlinsol_fixedpoint (see
example/cv_analytic_fp.f90). To pass problem data to
the right-hand side, extend cvode_solver with your own components and use
select type inside the function. The programs in example/ are
ports of the SUNDIALS C examples and show this and the other solver options.
The reference environment builds the pinned C SUNDIALS and runs the trace drivers
in reference/:
pixi run -e reference ref-build # fetch + build SUNDIALS v7.9.0 (once)
pixi run -e reference ref-run # run the C trace drivers, regenerate test data
pixi run -e reference compare # compare FVODE traces against the C traces
FVODE is released under the MIT License.
FVODE is derived from SUNDIALS, which is Copyright (c) 2002-2026, Lawrence Livermore National Security, Southern Methodist University, University of Maryland Baltimore County, and the SUNDIALS contributors, and is distributed under the BSD 3-Clause License. The SUNDIALS license and notice are reproduced in LICENSE-SUNDIALS.
- Original CVODE: https://github.com/LLNL/sundials
- A. C. Hindmarsh et al., "SUNDIALS: Suite of Nonlinear and Differential/Algebraic Equation Solvers," ACM Trans. Math. Softw. 31(3), 2005.
- D. J. Gardner et al., "Enabling new flexibility in the SUNDIALS suite of nonlinear and differential/algebraic equation solvers," ACM Trans. Math. Softw. 48(3), 2022.
- Modernized DVODE: https://github.com/jacobwilliams/dvode
- G. D. Byrne and A. C. Hindmarsh, "A Polyalgorithm for the Numerical Solution of Ordinary Differential Equations," ACM Trans. Math. Softw. 1(1), 1975 (EPISODE).
- A. C. Hindmarsh, "ODEPACK, A Systematized Collection of ODE Solvers," in Scientific Computing, R. S. Stepleman et al. (eds.), North-Holland, 1983 (LSODE).
- P. N. Brown, G. D. Byrne and A. C. Hindmarsh, "VODE: A Variable-Coefficient ODE Solver," SIAM J. Sci. Stat. Comput. 10(5), 1989.
- S. D. Cohen and A. C. Hindmarsh, "CVODE, a Stiff/Nonstiff ODE Solver in C," Computers in Physics 10(2), 1996.