yonderdrake 0.1.0a1

A library for nonlocal time and space operators in Firedrake

Yonderdrake

Fractional in time, space and other nonlocal operators for Firedrake

Alpha software: Yonderdrake has been broadly tested, but bugs and missing features may remain. Please report them as issues.

Yonderdrake adds various fractional time derivatives, fading-memory operators, and spatial fractional Laplacians directly to UFL forms solved with Firedrake. Time- and space-nonlocal operators can also be combined in the same equation.

The eventual goal is to gather all FEM-compatible methods for fractional differential equations in one place, so that comparing or switching between them does not mean rebuilding the problem each time.

Features

• Caputo and initialized Riemann-Liouville fractional-in-time derivatives with various methods including static memory diffusive representations, full-history stepping along with additional implementations from the literature for easy comparisons.
• General single-timescale exponential memory operators, including a convenience wrapper for the Caputo-Fabrizio operator.
• Homogeneous-Dirichlet spectral, zero-exterior Riesz, and periodic Fourier fractional Laplacians.
• 2D and 3D Caputo-Wismer waves with heterogeneous density, driven sources, impedance boundaries, PML, configurable sensor arrays, exact adjoints, time reversal, and regularized reconstruction.
• Variable timesteps, PETSc solver configuration, MPI execution, and checkpoint/restart.
• Compatibility with Irksome for classical time stepping alongside Yonderdrake operators.

Examples

Fractional time

Three sources in a BrainWeb anatomical head with material-dependent Caputo-Wismer damping:

Recovering a vessel-shaped initial pressure from measurements around a realistic head. The first two panels compare the true source with its reconstruction. The third shows the pressure recorded by the sensor array:

Fractional space

Classical, spectral-fractional, and Riesz heat flow on a Koch snowflake:

See the guides and examples for small, reproducible problems and the demo gallery for the full applications.

Installation

Create a Firedrake environment:

git clone https://github.com/TSGut/yonderdrake.git
cd yonderdrake
python -m pip install .

Add the plotting dependencies to run the gallery demos or regenerate their media:

python -m pip install '.[visual]'

For development:

python -m pip install -e '.[dev,docs]'

Firedrake supplies MPI and PETSc. See supported platforms.

Documentation

Start with the quickstart, then the guides and examples. The mathematics and methods summarize the supported algorithms and the papers behind them. The API reference gives exact signatures and restrictions.

Contributing

See CONTRIBUTING.md for what a numerical change should include. LLM-assisted contributions are welcome in principle and are held to the same standards as all others. The human author remains responsible for the code they submit.

Logo

The logo nods to the long memory of time-fractional operators: a fractional derivative still feels the entire history that preceded it. The logo dragon is inspired by the Lindwurmbrunnen in Klagenfurt, Austria, drawn in a viridis-like colour scheme.