Welcome to ExaGOOP’s documentation!

ExaGOOP is a high-performance computing Material Point Method (MPM) solver for continuum mechanics problems involving gaseous, liquid, and solid phases. It is developed at the National Laboratory of the Rockies, built on the AMReX framework, and runs on CPUs, GPUs, and heterogeneous architectures at scale.

Introduction:

• Introduction
  • About ExaGOOP
  • Background and Motivation
  • Key Features

Getting Started:

• Getting Started
  • System Requirements
  • Obtaining the Source
  • Building with CMake
  • Building with GNUmake
  • Verifying the Build
  • Visualizing Output
  • Getting Help

Tutorials:

• Setting up the simulation folder
• Setting up the input file
• Generating initial material point file
• Running ExaGOOP and viewing output files
• Tutorial: 2-D Steady Heat Conduction around a Cylinder (Dirichlet)
  • Physical problem
  • Analytical solution
  • Material properties
  • Domain and discretisation
  • Boundary conditions
  • Setting up the test case
  • Building
  • Running
  • Post-processing and validation
  • Expected result

User Guide:

• Input File Reference
  • Running the solver
  • Particle File Format
  • Input Parameter File
  • mpm. namespace — Domain and Grid
  • mpm. namespace — Time Control
  • mpm. namespace — Physics
  • mpm. namespace — Material Points
  • mpm. namespace — Output
  • mpm. namespace — Diagnostics
  • mpm. namespace — Level-Set Output
  • mpm. namespace — Momentum Boundary Conditions
  • mpm. namespace — Temperature Boundary Conditions (USE_TEMP only)
  • amr. namespace — Restart
  • eb2. namespace — Embedded Boundaries (USE_EB only)
  • Per-body namespace <body_name>. (USE_EB only)
  • Minimal Working Example

Physics Modules:

• Physics Modules
  • Temperature Module
  • Embedded Boundaries / Level Sets
  • UDF Moving Wall Boundary Conditions
  • Combining Modules
• Temperature Module (USE_TEMP)
  • Enabling the module at build time
  • Autogeneration parameters
  • Temperature boundary conditions
  • Nodal fields added by the temperature module
  • Per-particle thermal fields
  • Time-step sequence for the thermal solve
  • Minimal input file snippet
  • Verification test cases
• Embedded Boundaries via Level Sets (USE_EB)
  • Build requirements
  • Multi-body implementation
  • Supported geometry types
  • Momentum level-set boundary conditions
  • Temperature level-set boundary conditions
  • Implementation notes
  • Complete per-body input block example
• UDF Moving Wall Boundary Conditions
  • Overview
  • UDF interface
  • Building the shared library
  • Linking the solver against libdl
  • Input file parameters
  • Implementation details
  • Supported face labels
  • Limitations

Numerical Methods:

• Numerical Methods
  • Governing equations of continuum mechanics
  • Governing Equations of MPM
  • MPM discretisation steps

Validation and Verification:

• Axial vibration of an elastic bar
  • Effect of \(\alpha_{P-F}\)
  • Effect of \(CFL\)
• Collision of two-dimensional elastic disks
• Dam break simulation
• Torsion of a three-dimensional elastic column

Build Reference:

• Build Options Reference
  • USE_TEMP — Temperature Module
  • USE_EB — Embedded Boundaries
  • AMREX_USE_HDF5 — HDF5 Checkpoint/Restart
  • PRECISION — Floating-Point Width
  • DIM — Spatial Dimensions
  • PROFILE — Full AMReX Profiling
  • TINY_PROFILE — Lightweight Profiling
  • DEBUG — Debug Build
  • FSANITIZER — Address and Undefined-Behaviour Sanitizers

References:

• References