Advanced Usage

Master advanced Underworld3 techniques for research-grade simulations.

Topics

Parallel Computing

Write MPI-safe scripts and understand domain decomposition.

→ Parallel Computing Guide

Performance Optimization

Profile, optimize, and scale your simulations.

→ Performance Guide

Complex Rheologies

Implement advanced material models and constitutive laws.

→ Complex Rheologies

VEP with Transverse Isotropy for Fault Mechanics

Viscoelastic-plastic rheology with anisotropic weak planes and resolved fault-plane yield for modelling fault zones.

→ VEP + Transverse Isotropy

Custom Meshes

Create complex geometries with gmsh for research problems.

→ Custom Mesh Creation

Boundary Conditions on Curved Surfaces

Accurate free-slip and Neumann conditions on elliptical and non-planar boundaries.

→ Curved Boundary Conditions

Mesh Adaptation

Dynamic remeshing and adaptive refinement strategies.

→ Mesh Adaptation

Porous Media Flow

Darcy flow, Richards equation, and variably-saturated groundwater modelling.

→ Porous Media Flow

State Snapshots & Restore

A “stash for timesteps”: snapshot the full model state, try a step, restore exactly if you don’t like it. For backtracking, adaptive Δt, and predictor–corrector workflows.

→ State Snapshots & Restore

Troubleshooting

Common issues, debugging strategies, and solutions.

→ Troubleshooting Guide

API Patterns

Understanding common design patterns helps you write better Underworld3 code.

→ API Patterns

Prerequisites

This section assumes familiarity with:

Next Steps

Ready to contribute to Underworld3?

→ Developer Guide