Underworld3 v3.0.1

Patch release with build reliability fixes and documentation improvements.

Bug Fixes

Fix petsc_save_checkpoint() to use XDMF compatibility groups (fixes #80)
Fix stale build cache: ./uw build now uses --no-cache-dir to prevent
pip from reusing wheels compiled against the wrong PETSc
Fix Dockerfile resilience to dependency version differences
Fix binder launcher dispatch payload and YAML quoting

Improvements

Auto-detect binder launcher ref from git tag in RTD documentation
Add manual dispatch overrides for binder image builds
Update README with binder badges for v0.99, v3.0.0, and development

Contributors

Underworld development team with AI support from Claude Code.

Assets 2

22 Mar 00:54

lmoresi

v3.0.0

5742e6a

Underworld3 v3.0.0

First official release of Underworld3 -- a complete rewrite of the Underworld
geodynamics framework built on PETSc DMPlex, SymPy-based constitutive models,
and particle-in-cell methods.

Highlights

PETSc DMPlex-based meshing with simplex and structured meshes
SymPy-powered constitutive model framework with JIT compilation
Particle swarms with RBF-interpolated proxy mesh variables
Stokes, Poisson, Darcy, advection-diffusion, and Navier-Stokes solvers
Units and scaling system via Pint
Parallel-safe output with XDMF/HDF5 checkpointing
Mathematical mixin for natural variable arithmetic

New Features

Boundary integrals via uw.maths.BdIntegral (PR #70)
Platform-conditional MPI: OpenMPI on macOS, MPICH on Linux (PR #75)
PetscDS constants mechanism for runtime-updatable solver parameters (PR #87)
XDMF-compatible HDF5 output with field projection and tensor repacking (PR #72)
Parallel printing with uw.pprint() and uw.selective_ranks() context manager
uw.Params for named simulation parameters routed through PetscDS constants
Viscoelastic Stokes solver with explicit stress history (order-1 and order-2)

Improvements

Thread capping (OMP_NUM_THREADS=1) set in pixi activation and at import time
Internal boundary ownership patch for PETSc (ghost filtering fix)
setuptools-scm for automatic git tag-based versioning
./uw CLI for build, test, worktree management, and environment setup

Contributors

Underworld development team: Louis Moresi, Julian Giordani, Thyagarajulu Gollapalli,
Ben Knight, John Googas Graciosa, with AI support from Claude Code.

Assets 2