2.4.10 Solver comparison

This example shows how to set up solvers explicitly and how to extract diagnostic information.

Diagnostic information for explicit Euler solver:
{'controller': {'mpi_run': False, 't_start': 0, 't_end': 1.0, 'profiler': {'solver': 0.003192149999989624, 'tracker': 4.673000000821048e-05, 'compilation': 6.335692252000001}, 'solver_start': '2026-07-10 11:06:26.314883+00:00', 'successful': True, 'stop_reason': 'Reached final time', 'solver_duration': '0:00:00.003232', 't_final': 1.0}, 'package_version': 'unknown', 'solver': {'class': 'EulerSolver', 'pde_class': 'DiffusionPDE', 'dt': 0.001, 'steps': 1000, 'dt_adaptive': False, 'stochastic': False, 'backend': {'name': 'numba', 'implementation': 'numba'}, 'post_step_data': None}}

Diagnostic information for explicit, adaptive Runge-Kutta solver:
{'controller': {'mpi_run': False, 't_start': 0, 't_end': 1.0, 'profiler': {'solver': 0.0006047600000016473, 'tracker': 5.826999999669624e-05, 'compilation': 7.397274486000001}, 'solver_start': '2026-07-10 11:06:33.721274+00:00', 'successful': True, 'stop_reason': 'Reached final time', 'solver_duration': '0:00:00.000655', 't_final': 1.0}, 'package_version': 'unknown', 'solver': {'class': 'RungeKuttaSolver', 'pde_class': 'DiffusionPDE', 'dt': 0.20560436638833754, 'steps': 12, 'dt_adaptive': True, 'stochastic': False, 'backend': {'name': 'numba', 'implementation': 'numba'}, 'dt_statistics': {'min': 0.001, 'max': 0.1732257502111659, 'mean': 0.08333333333333334, 'std': 0.05283842008263937, 'count': 12.0}, 'post_step_data': None}}

Diagnostic information for implicit solver:
{'controller': {'mpi_run': False, 't_start': 0, 't_end': 1.0, 'profiler': {'solver': 0.014024109000004614, 'tracker': 4.953099998772359e-05, 'compilation': 4.261013558000002}, 'solver_start': '2026-07-10 11:06:37.991862+00:00', 'successful': True, 'stop_reason': 'Reached final time', 'solver_duration': '0:00:00.014069', 't_final': 1.0}, 'package_version': 'unknown', 'solver': {'class': 'ImplicitSolver', 'pde_class': 'DiffusionPDE', 'dt': 0.001, 'steps': 1000, 'dt_adaptive': False, 'stochastic': False, 'backend': {'name': 'numba', 'implementation': 'numba'}, 'function_evaluations': 0, 'post_step_data': None}}

Diagnostic information for Crank-Nicolson solver:
{'controller': {'mpi_run': False, 't_start': 0, 't_end': 1.0, 'profiler': {'solver': 0.01984301999999616, 'tracker': 5.086999999548425e-05, 'compilation': 6.2571127670000095}, 'solver_start': '2026-07-10 11:06:44.269993+00:00', 'successful': True, 'stop_reason': 'Reached final time', 'solver_duration': '0:00:00.019890', 't_final': 1.0}, 'package_version': 'unknown', 'solver': {'class': 'CrankNicolsonSolver', 'pde_class': 'DiffusionPDE', 'dt': 0.001, 'steps': 1000, 'dt_adaptive': False, 'stochastic': False, 'backend': {'name': 'numba', 'implementation': 'numba'}, 'function_evaluations': 0, 'post_step_data': None}}

Diagnostic information for Adam-Bashforth solver:
{'controller': {'mpi_run': False, 't_start': 0, 't_end': 1.0, 'profiler': {'solver': 3.9847681990000012, 'tracker': 5.869099999245009e-05, 'compilation': 1.9437838820000053}, 'solver_start': '2026-07-10 11:06:46.243412+00:00', 'successful': True, 'stop_reason': 'Reached final time', 'solver_duration': '0:00:03.985357', 't_final': 1.0}, 'package_version': 'unknown', 'solver': {'class': 'AdamsBashforthSolver', 'pde_class': 'DiffusionPDE', 'dt': 0.001, 'steps': 1000, 'dt_adaptive': False, 'stochastic': False, 'backend': {'name': 'numba', 'implementation': 'numba'}, 'post_step_data': None}}

Diagnostic information for scipy solver:
{'controller': {'mpi_run': False, 't_start': 0, 't_end': 1.0, 'profiler': {'solver': 0.6433724989999945, 'tracker': 4.300900000941965e-05, 'compilation': 0.0014790000000033388}, 'solver_start': '2026-07-10 11:06:50.233090+00:00', 'successful': True, 'stop_reason': 'Reached final time', 'solver_duration': '0:00:00.643507', 't_final': np.float64(1.0)}, 'package_version': 'unknown', 'solver': {'class': 'ScipySolver', 'pde_class': 'DiffusionPDE', 'dt': 0.001, 'steps': 55, 'stochastic': False, 'backend': {'name': 'numba', 'implementation': 'numba'}}}

import pde

# initialize the grid, an initial condition, and the PDE
grid = pde.UnitGrid([32, 32])
field = pde.ScalarField.random_uniform(grid, -1, 1)
eq = pde.DiffusionPDE()


def run_solver(solver, label):
    """Helper function testing the solver."""
    controller = pde.Controller(solver, t_range=1, tracker=None)
    sol = controller.run(field, dt=1e-3)
    sol.label = label + " solver"
    print(f"Diagnostic information for {sol.label}:")
    print(controller.diagnostics)
    print()
    return sol


# try different solvers
solutions = [
    run_solver(pde.EulerSolver(eq), "explicit Euler"),
    run_solver(
        pde.RungeKuttaSolver(eq, adaptive=True), "explicit, adaptive Runge-Kutta"
    ),
    run_solver(pde.ImplicitSolver(eq), "implicit"),
    run_solver(pde.CrankNicolsonSolver(eq), "Crank-Nicolson"),
    run_solver(pde.AdamsBashforthSolver(eq), "Adam-Bashforth"),
    run_solver(pde.ScipySolver(eq), "scipy"),
]

# plot both fields and give the deviation as the title
deviations = [(solutions[0] - sol).fluctuations for sol in solutions]
title = "Deviation: " + ", ".join(f"{deviation:.2g}" for deviation in deviations[1:])
pde.FieldCollection(solutions).plot(title=title, arrangement=(2, 3))