Postprocess_ASPECT

Current release: 2.0.0

Read the complete Postprocess_ASPECT documentation

Postprocess_ASPECT is a Python-first, configuration-driven toolkit for post-processing output from the ASPECT geodynamics code. A single YAML file selects models, analyses, output locations, scientific parameters, and local or Slurm resources.

The recommended entry point is:

python -m pip install -e .
cp config/postprocess.example.yaml config/postprocess.user.yaml
aspect-postprocess check --config config/postprocess.user.yaml
aspect-postprocess run --config config/postprocess.user.yaml

The workflow currently covers direct solution_surface processing, topography, generic and depth statistics, PlateRecipy segmentation and plate lineages, true polar wander, ParaView extraction, spherical harmonics, Fatbox, and optional external programs.

Repository direction

• postprocess_aspect/ is the maintained Python package and public workflow.
• postprocess.py is a compatibility launcher for the Python CLI.
• config/ contains public examples and ignored private user configuration.
• docs/ contains the Read the Docs/MkDocs documentation.
• legacy/python_paraview_mixed/ preserves the former mixed Python_paraview/ tree while tested analyses move into the package.
• legacy/matlab/ contains the historical MATLAB workflow and standalone research scripts.
• Existing MATLAB entry points and helper directories are retained as a legacy workflow. They are not required by the Python-first workflow unless the optional matlab stage is enabled.

Research routines are migrated incrementally after their inputs, outputs, and scientific assumptions have tests. This preserves existing results while removing hard-coded paths and model lists.

See the workflow guide, the public documentation, and the architecture and migration guide.

Documentation

Build the documentation locally with:

python -m pip install -r docs/requirements.txt
mkdocs serve

The documentation is published automatically on Read the Docs from mkdocs.yml and .readthedocs.yaml.