Dedalus: A flexible framework for numerical simulations with spectral methods

Numerical solutions of partial differential equations enable a broad range of scientific research. The Dedalus Project is a flexible, open-source, parallelized computational framework for solving general partial differential equations using spectral methods. Dedalus translates plain-text strings describing partial differential equations into efficient solvers. This paper details the numerical method that enables this translation, describes the design and implementation of the codebase, and illustrates its capabilities with a variety of example problems. The numerical method is a first-order generalized tau formulation that discretizes equations into banded matrices. This method is implemented with an object-oriented design. Classes for spectral bases and domains manage the discretization and automatic parallel distribution of variables. Discretized fields and mathematical operators are symbolically manipulated with a basic computer algebra system. Initial value, boundary value, and eigenvalue problems are efficiently solved using high-performance linear algebra, transform, and parallel communication libraries. Custom analysis outputs can also be specified in plain text and stored in self-describing portable formats. The performance of the code is evaluated with a parallel scaling benchmark and a comparison to a finite-volume code. The features and flexibility of the codebase are illustrated by solving several examples: the nonlinear Schrodinger equation on a graph, a supersonic magnetohydrodynamic vortex, quasigeostrophic flow, Stokes flow in a cylindrical annulus, normal modes of a radiative atmosphere, and diamagnetic levitation. The Dedalus code and the example problems are available online at this http URL.

• Publication year

  2019

• Venue

  Physical Review Research

• Publication date

  2019-05-24

• Fields of study

  Mathematics, Physics, Computer Science

• Identifiers
  DOI 10.1103/PhysRevResearch.2.023068arXiv 1905.10388
• External record

  Open on Semantic Scholar

• Source metadata

  Semantic Scholar

• No claims are published for this paper.

• No concepts are published for this paper.

• Parallel-in-time integration of kinematic dynamos

  2019cited by this paper
• Chiral Maxwell waves in continuous media from Berry monopoles

  2019cited by this paper
• Diffused-interface Rayleigh-Taylor instability with a nonlinear equation of state

  2019cited by this paper
• Buoyancy‐driven entrainment in dry thermals

  2019cited by this paper
• Magnetic eddy viscosity of mean shear flows in two-dimensional magnetohydrodynamics

  2019cited by this paper
• Entropy Rain: Dilution and Compression of Thermals in Stratified Domains

  2019cited by this paper
• Modeling and pricing of space weather derivatives

  2019cited by this paper
• The "Sphered Cube": A New Method for the Solution of Partial Differential Equations in Cubical Geometry

  2019cited by this paper
• Improving accuracy of volume penalised fluid-solid interactions

  2019cited by this paper
• Solitary zonal structures in subcritical drift waves: a minimum model

  2019cited by this paper
• Tracer Transport within Abyssal Mixing Layers

  2019cited by this paper
• Under‐ice salinity transport in low‐salinity waterbodies

  2019cited by this paper
• Improved bounds on horizontal convection

  2019cited by this paper
• Viscous dissipation in two-dimensional compression of turbulence

  2019cited by this paper
• Topological Gaseous Plasmon Polariton in Realistic Plasma.

  2019cited by this paper
• Theory of the Tertiary Instability and the Dimits Shift from Reduced Drift-Wave Models.

  2019cited by this paper
• SciPy 1.0: fundamental algorithms for scientific computing in Python

  2019cited by this paper
• Multiple scales analysis of slow–fast quasi-linear systems

  2019cited by this paper
• Low-frequency Variability in Massive Stars: Core Generation or Surface Phenomenon?

  2019cited by this paper
• Predicting critical ignition in slow-fast excitable models.

  2019cited by this paper
• Adjuvanted influenza vaccine dynamics

  2019cited by this paper
• Nontrivial topology of the Alfvén continuum and topological character of reversed-shear Alfvén eigenmodes

  2019cited by this paper
• On symmetrizing the ultraspherical spectral method for self-adjoint problems

  2019cited by this paper
• Radiative heating achieves the ultimate regime of thermal convection

  2018cited by this paper
• Energy-conserving Galerkin approximations for quasigeostrophic dynamics

  2018cited by this paper
• Buoyant Motion of a Turbulent Thermal

  2018cited by this paper
• Convection-driven kinematic dynamos with a self-consistent shear flow

  2018cited by this paper
• Perspectives on Reproducibility and Sustainability of Open-Source Scientific Software from Seven Years of the Dedalus Project

  2018cited by this paper
• Generalized quasilinear approximation of the interaction of convection and mean flows in a thermal annulus

  2018cited by this paper
• Similarities between action potentials and acoustic pulses in a van der Waals fluid

  2018cited by this paper
• It sounds like an action potential: unification of electrical, chemical and mechanical aspects of acoustic pulses in lipids

  2018cited by this paper
• Energy transfer in resonant and near-resonant internal wave triads for weakly non-uniform stratifications

  2018cited by this paper
• Quantum hydrodynamics for supersolid crystals and quasicrystals

  2018cited by this paper
• A bulk-interface correspondence for equatorial waves

  2018cited by this paper
• An inverse technique for reconstructing ocean’s density stratification from surface data

  2018cited by this paper
• Topological transition in stratified fluids

  2018cited by this paper
• Restratification of Abyssal Mixing Layers by Submesoscale Baroclinic Eddies

  2018cited by this paper
• Submesoscale Baroclinic Instability in the Bottom Boundary Layer

  2018cited by this paper
• Salinity Control of Thermal Evolution of Late Summer Melt Ponds on Arctic Sea Ice

  2018cited by this paper
• Turbulence in vertically averaged convection

  2018cited by this paper
• Tensor calculus in spherical coordinates using Jacobi polynomials. Part-I: Mathematical analysis and derivations

  2018cited by this paper
• Connection between nonlinear energy optimization and instantons.

  2018cited by this paper
• Role of stable modes in driven shear-flow turbulence

  2018cited by this paper
• Predicting the Rossby Number in Convective Experiments

  2018cited by this paper
• Black hole accretion discs and luminous transients in failed supernovae from non-rotating supergiants

  2018cited by this paper
• The energy flux spectrum of internal waves generated by turbulent convection

  2018cited by this paper
• Entrainment in Resolved, Dry Thermals

  2018cited by this paper
• A simple system for moist convection: the Rainy–Bénard model

  2018cited by this paper
• Convective Dynamics and Disequilibrium Chemistry in the Atmospheres of Giant Planets and Brown Dwarfs

  2018cited by this paper
• Tensor calculus in spherical coordinates using Jacobi polynomials. Part-II: Implementation and examples

  2018cited by this paper
• Order Out of Chaos: Slowly Reversing Mean Flows Emerge from Turbulently Generated Internal Waves.

  2018cited by this paper
• Accelerated evolution of convective simulations

  2018cited by this paper
• Hybrid Chebyshev function bases for sparse spectral methods in parity-mixed PDEs on an infinite domain

  2017cited by this paper
• Spatial Evolution of Human Dialects

  2017cited by this paper
• Anomalous Chained Turbulence in Actively Driven Flows on Spheres.

  2017cited by this paper
• Correspondence between constrained transport and vector potential methods for magnetohydrodynamics

  2017cited by this paper
• Dynamics of Mixed Convective--Stably-Stratified Fluids

  2017cited by this paper
• A fourth-order accurate finite volume method for ideal MHD via upwind constrained transport

  2017cited by this paper
• A Vorticity-preserving Hydrodynamical Scheme for Modeling Accretion Disk Flows

  2017cited by this paper
• The Magnitude of Viscous Dissipation in Strongly Stratified Two-dimensional Convection

  2017cited by this paper
• Strong wave–mean-flow coupling in baroclinic acoustic streaming

  2017cited by this paper
• Unmixing demonstration with a twist: A photochromic Taylor-Couette device

  2017cited by this paper
• The Weakly Nonlinear Magnetorotational Instability in a Local Geometry

  2016cited by this paper
• The effects of Ekman pumping on quasi-geostrophic Rayleigh–Bénard convection

  2016cited by this paper
• Constrained hyperbolic divergence cleaning in smoothed particle magnetohydrodynamics with variable cleaning speeds

  2016cited by this paper
• Three-dimensional rotating Couette flow via the generalised quasilinear approximation

  2016cited by this paper
• Conversion of internal gravity waves into magnetic waves

  2016cited by this paper
• An asymptotic model for the propagation of oceanic internal tides through quasi-geostrophic flow

  2016cited by this paper
• A nonlinear model for rotationally constrained convection with Ekman pumping

  2016cited by this paper
• The Weakly Nonlinear Magnetorotational Instability in a Global, Cylindrical Taylor–Couette Flow

  2016cited by this paper
• TURBULENT CHEMICAL DIFFUSION IN CONVECTIVELY BOUNDED CARBON FLAMES

  2016cited by this paper
• Convective heat transport in stratified atmospheres at low and high Mach number

  2016cited by this paper
• Compressing turbulence and sudden viscous dissipation with compression-dependent ionization state.

  2016cited by this paper
• A three-component model for the coupled evolution of near-inertial waves, quasi-geostrophic flow and the near-inertial second harmonic

  2016cited by this paper
• Tensor calculus in polar coordinates using Jacobi polynomials

  2015cited by this paper
• A validated non-linear Kelvin-Helmholtz benchmark for numerical hydrodynamics

  2015cited by this paper
• STELLAR MIXING LENGTH THEORY WITH ENTROPY RAIN

  2015cited by this paper
• Sudden Viscous Dissipation of Compressing Turbulence.

  2015cited by this paper
• LOCAL RADIATION HYDRODYNAMIC SIMULATIONS OF MASSIVE STAR ENVELOPES AT THE IRON OPACITY PEAK

  2015cited by this paper
• On the magnetorotational instability and elastic buckling

  2015cited by this paper
• Available potential vorticity and wave-averaged quasi-geostrophic flow

  2015cited by this paper
• Rectangular spectral collocation

  2015cited by this paper
• CONDUCTION IN LOW MACH NUMBER FLOWS. I. LINEAR AND WEAKLY NONLINEAR REGIMES

  2014cited by this paper
• Approaching the asymptotic regime of rapidly rotating convection: boundary layers versus interior dynamics.

  2014cited by this paper
• A multiscale algorithm for simulating spatially-extended Langmuir circulation dynamics

  2014cited by this paper
• Numerical simulations of internal wave generation by convection in water.

  2014cited by this paper
• Nonlinear Schrödinger equation on graphs: recent results and open problems

  2013cited by this paper
• Near-polytropic stellar simulations with a radiative surface

  2013cited by this paper
• ENERGY CONSERVATION AND GRAVITY WAVES IN SOUND-PROOF TREATMENTS OF STELLAR INTERIORS. II. LAGRANGIAN CONSTRAINED ANALYSIS

  2013cited by this paper
• Introduction to Quantum Graphs

  2012cited by this paper
• A GODUNOV METHOD FOR MULTIDIMENSIONAL RADIATION MAGNETOHYDRODYNAMICS BASED ON A VARIABLE EDDINGTON TENSOR

  2012cited by this paper
• A Fast and Well-Conditioned Spectral Method

  2012cited by this paper
• Heat transport in low-Rossby-number Rayleigh-Bénard convection.

  2012cited by this paper
• Spectral integration of linear boundary value problems

  2012cited by this paper
• I and J

  2012cited by this paper
• HIGH-LUNDQUIST NUMBER SCALING IN THREE-DIMENSIONAL SIMULATIONS OF PARKER'S MODEL OF CORONAL HEATING

  2011cited by this paper
• Anomalous price impact and the critical nature of liquidity in financial markets

  2011cited by this paper
• Cython: The Best of Both Worlds

  2011cited by this paper
• On linearization and connection coefficients for generalized Hermite polynomials

  2011cited by this paper
• The best of both worlds

  2010cited by this paper

• Conservation laws, fluxes, and symmetries: lessons from a perturbative approach for self-organized turbulence

  2026cites this paper
• Available Energy and Ground States of Convective Hydrodynamic and Hydromagnetic Instabilities

  2026cites this paper
• Structures of elastoinertial turbulence in pipe flow

  2026cites this paper
• Time-Delayed Transformers for Data-Driven Modeling of Low-Dimensional Dynamics

  2026cites this paper
• From Penrose to Melrose: Computing Scattering Amplitudes at Infinity for Unbounded Media

  2026cites this paper
• Neuro-Symbolic Multitasking: A Unified Framework for Discovering Generalizable Solutions to PDE Families

  2026cites this paper
• On the entrapment of particles by vortical structures in wall-bounded turbulence

  2026cites this paper
• Lattice Boltzmann methods for simulating non-Newtonian fluids: A comprehensive review

  2026cites this paper
• Flowers: A Warp Drive for Neural PDE Solvers

  2026cites this paper
• Large-scale dynamos driven by shear-flow-induced jets

  2026influential citation
• Disentangling Entropic, Active, and Frictional Forces in Cytoskeletal Crosslinking

  2026cites this paper
• The Unsteady Taylor--Vortex Dynamo is Fast

  2026cites this paper
• Exact coherent structures as building blocks of turbulence on large domains

  2026cites this paper
• Efficient turbulent drag reduction using targeted polymer additives

  2025cites this paper
• Radial modes of pressure bumps and dips in astrophysical discs

  2025cites this paper
• Oceanic internal tides: do they get phased at the Equator?

  2025influential citation
• High-level, high-resolution ocean modeling at all scales with Oceananigans

  2025cites this paper
• Numerical investigation of dynamic stall on wings following curved trajectory

  2025cites this paper
• Role of partial stable stratification on the onset of rotating magnetoconvection with a uniform horizontal field

  2025cites this paper
• On the essential structure of exact traveling-wave solutions in viscoelastic flow

  2025cites this paper
• Stability of propagating plane inertial waves in rotating fluids

  2025cites this paper
• Inflection point instability in Hartmann channel flow with variable electric conductivity

  2025cites this paper
• Model of deep zonal flows in giant planets

  2025cites this paper
• Stabilizing Rayleigh-Benard convection with reinforcement learning trained on a reduced-order model

  2025cites this paper
• On the applicability of the actuator line method for unsteady aerodynamics

  2025cites this paper
• Radiatively-cooled moist convection under idealised climate change scenarios: linear analysis

  2025cites this paper
• Role of partial stable stratification on the onset of rotating magnetoconvection with a uniform vertical field

  2025cites this paper
• Efficient Generative Transformer Operators For Million-Point PDEs

  2025cites this paper
• Mitigation of numerical asymmetries induced by Cartesian meshes with pseudo-spectral method in hydrodynamics simulations

  2025cites this paper
• The latent variable proximal point algorithm for variational problems with inequality constraints

  2025influential citation
• Quasi-geostrophic limiting dynamics and energetics of the LANS-$\alpha$ model

  2025cites this paper
• Rescaled equations for well-conditioned direct numerical simulations of rapidly rotating convection

  2025cites this paper
• Preferential concentration of particles in a decaying isotropic turbulence in the dilute regime

  2025cites this paper
• Nonlinear periodic orbit solutions and their bifurcation structure at the origin of soliton hopping in coupled microresonators

  2025cites this paper
• Trading Carbon for Physics: On the Resource Efficiency of Machine Learning for Spatio-Temporal Forecasting

  2025cites this paper
• Spatially localised doubly diffusive convection in an axisymmetric spherical shell

  2025cites this paper
• Revisiting two-dimensional viscoelastic Kolmogorov flow: a centre-mode-driven transition

  2025cites this paper
• Spontaneous generation of helical flows by salt fingers

  2025cites this paper
• Overtone: Cyclic Patch Modulation for Clean, Efficient, and Flexible Physics Emulators

  2025cites this paper
• Staircases of passive and active scalar concentration in cellular flow

  2025cites this paper
• Data-driven quantum Koopman method for simulating nonlinear dynamics

  2025cites this paper
• Effervescence in a binary mixture with nonlinear non-reciprocal interactions

  2025cites this paper
• Observations and Fully Coupled Simulations of Nighttime Ionospheric Irregularities in the Subauroral E Region

  2025cites this paper
• Follow the curvature of viscoelastic stress: Insights into the steady arrowhead structure

  2025cites this paper
• The reflection-transmission problem for inertial waves on geostrophic shear layers

  2025influential citation
• CFD-LLMBench: A Benchmark Suite for Evaluating Large Language Models in Computational Fluid Dynamics

  2025cites this paper
• Thermal effects on the dynamics of vortex breakdown in spherical Couette flow

  2025cites this paper
• Nonmodal growth and optimal perturbations in magnetohydrodynamic shear flows

  2025cites this paper
• Uncertainty in elastic turbulence

  2025influential citation
• How Ice Composition Controls Radiatively Driven Convection Under Lake Ice

  2025cites this paper
• Topology of shallow-water waves on a rotating sphere

  2025cites this paper
• Deuterium and tritium anomalous transport in the generalized Hasegawa–Wakatani resistive drift wave turbulence model with finite ion Larmor radius

  2025cites this paper
• Comparing the magnetic Rayleigh-Taylor instability dynamics in two- and three-dimensions

  2025cites this paper
• A unifying model of LAT condensates in reconstitution experiments

  2025cites this paper
• TANTE: Time-Adaptive Operator Learning via Neural Taylor Expansion

  2025cites this paper
• Flow regime shift and temperature model of the radiation-induced convection system under surface cooling

  2025cites this paper
• Instability triggered by mixed convection in a thin fluid layer

  2025cites this paper
• Magic of the Well: assessing quantum resources of fluid dynamics data

  2025cites this paper
• The Cross‐Over From Viscous to Inertial Lengthscales in Rapidly‐Rotating Convection

  2025cites this paper
• Dynamical constraints on the vertical structure of Jupiter's polar cyclones.

  2025influential citation
• Bounds on dissipation in three-dimensional planar shear flows: reduction to two-dimensional problems

  2025cites this paper
• Advancing numerical models for land-to-ocean litter transport: A review of hydrodynamic processes and inland contributions.

  2025cites this paper
• On the concentration distribution in turbulent thermals

  2025cites this paper
• CodePDE: An Inference Framework for LLM-driven PDE Solver Generation

  2025cites this paper
• PDE-Transformer: Efficient and Versatile Transformers for Physics Simulations

  2025cites this paper
• Lost in Latent Space: An Empirical Study of Latent Diffusion Models for Physics Emulation

  2025cites this paper
• Two-field theory for phase coexistence of active Brownian particles.

  2025cites this paper
• Advances in data-driven reduced order models using two-stage dimension reduction for coupled viscous flow and transport

  2025cites this paper
• QGDipoles.jl: A Julia package for calculating dipolar vortex solutions to the Quasi-Geostrophic equations

  2025cites this paper
• Breathe in, breathe out: Bacterial density determines collective migration in aerotaxis

  2025cites this paper
• Learning the dynamics of symmetry-reduced chaotic attractors from data.

  2025cites this paper
• Linear instability in planar viscoelastic Taylor-Couette flow with and without explicit polymer diffusion

  2025cites this paper
• Data-driven discovery of the equations of turbulent convection

  2025influential citation
• Compound Burgers-KdV Soliton Behaviour: Refraction, Reflection and Fusion

  2025cites this paper
• Spectral Derivatives

  2025cites this paper
• Elastic turbulence in highly entangled polymers and wormlike micelles

  2025cites this paper
• Fast automated adjoints for spectral PDE solvers

  2025cites this paper
• Parameter analysis in continuous data assimilation for various turbulence models

  2025cites this paper
• Two-dimensional Ekman-inertial instability: A comparison with inertial instability

  2025cites this paper
• Dispersion of active particles in oscillatory Poiseuille flow

  2025cites this paper
• A Phase-field Model for Apoptotic Cell Death

  2025cites this paper
• Exciting terahertz magnons with amplitude modulated light: spin pumping, squeezed states, symmetry breaking and pattern formation

  2025cites this paper
• An Analysis of Stable Mode Contributions to Rayleigh-B\'{e}nard Convection

  2025cites this paper
• Non-periodic Fourier propagation algorithms for partial differential equations

  2025cites this paper
• Penetration depth of flow perturbations into a stably stratified layer driven by rotating laterally heterogeneous convection

  2025cites this paper
• Head-on collision of longitudinal density pulses near phase transition: Insights from numerical simulations

  2025cites this paper
• Diffusive Braking of Penetrative Convection in Stably-Stratified Fluids

  2025influential citation
• Hydrodynamic instabilities in driven chiral suspensions

  2025cites this paper
• Streak generation in viscosity-stratified wall-bounded flows

  2025cites this paper
• Quantifying reconnection and its dynamical role in 2D magnetic Rayleigh–Taylor turbulence

  2025cites this paper
• Narwhals and their blessings: exact coherent structures of elastic turbulence in channel flows

  2025cites this paper
• Arrested coarsening, oscillations, and memory from a conserved phase separating nucleator in a self-straining cytoskeletal network

  2025cites this paper
• Localised proper orthogonal decomposition

  2025cites this paper
• A self-consistent numerical model of internal wave-induced mean flow oscillations in polar geometry

  2025cites this paper
• Aeolus 2.0's thermal rotating shallow water model: A new paradigm for simulating extreme heatwaves, westerly jet intensification, and more

  2025cites this paper
• A two-phase two-component slurry model of the F-layer at the base of Earth's core

  2025cites this paper
• Applications of numerical analysis in computer simulations

  2025influential citation
• Reframing Generative Models for Physical Systems using Stochastic Interpolants

  2025cites this paper
• Heat transport model for the transition between scaling regimes in quasistatic and full magnetoconvection

  2025cites this paper
• Climate impacts of forced equatorial superrotation in an idealized GCM

  2025cites this paper