A software framework for massively parallel block-structured adaptive mesh refinement applications.

[Overview](#Overview) - [Features](#Features) - [Documentation](#Documentation) - [Gallery](#Gallery) - [Get Help](#get-help) - [Contribute](#Contribute) - [Copyright Notice](#copyright-notice) - [License](#License) - [Citation](#Citation)

Overview

AMReX is a software framework designed to accelerate scientific discovery for applications solving partial differential equations on block-structured meshes. Its massively parallel adaptive mesh refinement (AMR) algorithms focus computational resources and allow scalable performance on heterogeneous architectures so that scientists can efficiently resolve details in large simulations. AMReX is developed at LBNL.

More information is available at the AMReX website.

Features

• C++ and Fortran interfaces
• Support for cell-centered, face-centered, edge-centered, and nodal data
• Support for hyperbolic, parabolic, and elliptic solves on a hierarchical adaptive grid structure
• Optional subcycling in time for time-dependent PDEs
• Support for particles
• Embedded boundary description of irregular geometry
• Parallelization via flat MPI, OpenMP, hybrid MPI/OpenMP, or MPI/MPI
• GPU Acceleration with CUDA (NVidia), HIP (AMD) or SYCL (Intel) backends
• Parallel I/O
• Plotfile format supported by Amrvis, VisIt, ParaView and yt
• Built-in profiling tools

Documentation

Four types of documentation are available:

• User's Guide -- For more information about AMReX features and functions
• Example Codes -- The fastest way to start your own project
• Guided Tutorials -- Learn basic AMReX topics in a progressive way
• Technical Reference -- Conveniently searchable code documentation via Doxygen
• Slides and video recordings -- From the AMReX tutorial organized by NERSC/OLCF/ALCF on March 14, 2024

Gallery

AMReX supports several Exascale Computing Project software applications, such as ExaSky, WarpX, Pele(Combustion), Astro, and MFiX-Exa. AMReX has also been used in a wide variety of other scientific simulations, some of which, can be seen in our application gallery.

Get Help

You can also view questions and ask your own on our GitHub Discussions page. To obtain additional help, simply post an issue.

Contribute

We are always happy to have users contribute to the AMReX source code. To contribute, issue a pull request against the development branch. Any level of changes are welcomed: documentation, bug fixes, new test problems, new solvers, etc. For more details on how to contribute to AMReX, please see CONTRIBUTING.md.

Copyright Notice

AMReX Copyright (c) 2024, The Regents of the University of California, through Lawrence Berkeley National Laboratory (subject to receipt of any required approvals from the U.S. Dept. of Energy). All rights reserved.

If you have questions about your rights to use or distribute this software, please contact Berkeley Lab's Intellectual Property Office at IPO@lbl.gov.

Please see the notices in NOTICE.

License

License for AMReX can be found at LICENSE.

Citation

To cite AMReX, please use

@article{AMReX_JOSS,
  doi = {10.21105/joss.01370},
  url = {https://doi.org/10.21105/joss.01370},
  year = {2019},
  month = may,
  publisher = {The Open Journal},
  volume = {4},
  number = {37},
  pages = {1370},
  author = {Weiqun Zhang and Ann Almgren and Vince Beckner and John Bell and Johannes Blaschke and Cy Chan and Marcus Day and Brian Friesen and Kevin Gott and Daniel Graves and Max Katz and Andrew Myers and Tan Nguyen and Andrew Nonaka and Michele Rosso and Samuel Williams and Michael Zingale},
  title = {{AMReX}: a framework for block-structured adaptive mesh refinement},
  journal = {Journal of Open Source Software}
}