Welcome to AMReX’s documentation

AMReX is a software framework containing all the functionality to write massively parallel, block-structured adaptive mesh refinement (AMR) applications. AMReX is freely available on Github.

AMReX is developed at LBNL.

All of AMReX’s development is done in the GitHub repository under the development branch; anyone can see the latest updates. A monthly release is tagged at the beginning of each month.

We are always happy to have users contribute to the AMReX source code. To contribute, issue a pull request against the development branch (details here). Any level of changes are welcomed: documentation, bug fixes, new test problems, new solvers, etc. To obtain help, simply post a discussion or an issue on the AMReX GitHub webpage.

To learn AMReX there are walk-through guides and small stand-alone example codes that demonstrate how to use different parts of the AMReX functionality. Extensive documentation is available at AMReX Guided Tutorials and Example Codes.

Besides this documentation, there is API documentation generated by Doxygen.

Documentation on migration from BoxLib is available in the AMReX repository at Docs/Migration.

Contents:

• AMReX Introduction
• Getting Started
• Building AMReX
• Basics
• Gridding and Load Balancing
• AmrCore Source Code
• Amr Source Code
• Fork-Join
• I/O (Plotfile, Checkpoint)
• Linear Solvers
• Particles
• Fortran Interface
• Python Interface
• Embedded Boundaries
• Discrete Fourier Transform
• Time Integration
• GPU
• Visualization
• Post-Processing
• Debugging
• Runtime Parameters
• AMReX-based Profiling Tools
• External Profiling Tools
• External Frameworks
• Regression Testing
• Frequently Asked Questions
• AMReX Governance

The copyright notice of AMReX is included in the AMReX home directory as README.txt. Your use of this software is under the 3-clause BSD license – the license agreement is included in the AMReX home directory as license.txt.

For a pdf version of this documentation, click here.