DOE PAGES title logo U.S. Department of Energy
Office of Scientific and Technical Information

Title: AMReX: a framework for block-structured adaptive mesh refinement

Abstract

AMReX is a C++ software framework that supports the development of block-structured adaptive mesh refinement (AMR) algorithms for solving systems of partial differential equations (PDEs) with complex boundary conditions on current and emerging architectures. AMR reduces the computational cost and memory footprint compared to a uniform mesh while preserving the local descriptions of different physical processes in complex multiphysics algorithms. Current AMReX-based application codes span a number of areas, including atmospheric modeling, astrophysics, combustion, cosmology, fluctuating hydrodynamics, multiphase flows, and particle accelerators. In particular, the AMReX-Astro GitHub repository holds a number of astrophysical modeling tools based on AMReX. The origins of AMReX trace back to the BoxLib software framework. AMReX supports a number of different time-stepping strategies and spatial discretizations. Solution strategies supported by AMReX range from level-by-level approaches (with or without subcycling in time) with multilevel synchronization to full-hierarchy approaches, and any combination thereof. User-defined kernels that operate on patches of data can be written in C++ or Fortran; there is also a Fortran-interface functionality which wraps the core C++ data structures and operations in Fortran wrappers so that an application code based on AMReX can be written entirely in Fortran.

Authors:
ORCiD logo [1]; ORCiD logo [1];  [1]; ORCiD logo [1]; ORCiD logo [1]; ORCiD logo [2]; ORCiD logo [1]; ORCiD logo [3]; ORCiD logo [3]; ORCiD logo [2]; ORCiD logo [4]; ORCiD logo [1]; ORCiD logo [2]; ORCiD logo [1]; ORCiD logo [1]; ORCiD logo [2]; ORCiD logo [5]
  1. Lawrence Berkeley National Lab. (LBNL), Berkeley, CA (United States). Center for Computational Sciences and Engineering (CCSE)
  2. Lawrence Berkeley National Lab. (LBNL), Berkeley, CA (United States). Computational Research Div.
  3. Lawrence Berkeley National Lab. (LBNL), Berkeley, CA (United States). National Energy Research Scientific Computing Center (NERSC)
  4. NVIDIA Corp., Santa Clara, CA (United States)
  5. Stony Brook Univ., NY (United States). Dept. of Physics and Astronomy
Publication Date:
Research Org.:
Lawrence Berkeley National Laboratory (LBNL), Berkeley, CA (United States)
Sponsoring Org.:
USDOE Office of Science (SC), Advanced Scientific Computing Research (ASCR)
OSTI Identifier:
1526603
Grant/Contract Number:  
AC02-05CH11231
Resource Type:
Accepted Manuscript
Journal Name:
Journal of Open Source Software
Additional Journal Information:
Journal Volume: 4; Journal Issue: 37; Journal ID: ISSN 2475-9066
Publisher:
Open Source Initiative - NumFOCUS
Country of Publication:
United States
Language:
English
Subject:
97 MATHEMATICS AND COMPUTING

Citation Formats

Zhang, Weiqun, Almgren, Ann, Beckner, Vince, Bell, John, Blaschke, Johannes, Chan, Cy, Day, Marcus, Friesen, Brian, Gott, Kevin, Graves, Daniel, Katz, Max, Myers, Andrew, Nguyen, Tan, Nonaka, Andrew, Rosso, Michele, Williams, Samuel, and Zingale, Michael. AMReX: a framework for block-structured adaptive mesh refinement. United States: N. p., 2019. Web. doi:10.21105/joss.01370.
Zhang, Weiqun, Almgren, Ann, Beckner, Vince, Bell, John, Blaschke, Johannes, Chan, Cy, Day, Marcus, Friesen, Brian, Gott, Kevin, Graves, Daniel, Katz, Max, Myers, Andrew, Nguyen, Tan, Nonaka, Andrew, Rosso, Michele, Williams, Samuel, & Zingale, Michael. AMReX: a framework for block-structured adaptive mesh refinement. United States. https://doi.org/10.21105/joss.01370
Zhang, Weiqun, Almgren, Ann, Beckner, Vince, Bell, John, Blaschke, Johannes, Chan, Cy, Day, Marcus, Friesen, Brian, Gott, Kevin, Graves, Daniel, Katz, Max, Myers, Andrew, Nguyen, Tan, Nonaka, Andrew, Rosso, Michele, Williams, Samuel, and Zingale, Michael. Sun . "AMReX: a framework for block-structured adaptive mesh refinement". United States. https://doi.org/10.21105/joss.01370. https://www.osti.gov/servlets/purl/1526603.
@article{osti_1526603,
title = {AMReX: a framework for block-structured adaptive mesh refinement},
author = {Zhang, Weiqun and Almgren, Ann and Beckner, Vince and Bell, John and Blaschke, Johannes and Chan, Cy and Day, Marcus and Friesen, Brian and Gott, Kevin and Graves, Daniel and Katz, Max and Myers, Andrew and Nguyen, Tan and Nonaka, Andrew and Rosso, Michele and Williams, Samuel and Zingale, Michael},
abstractNote = {AMReX is a C++ software framework that supports the development of block-structured adaptive mesh refinement (AMR) algorithms for solving systems of partial differential equations (PDEs) with complex boundary conditions on current and emerging architectures. AMR reduces the computational cost and memory footprint compared to a uniform mesh while preserving the local descriptions of different physical processes in complex multiphysics algorithms. Current AMReX-based application codes span a number of areas, including atmospheric modeling, astrophysics, combustion, cosmology, fluctuating hydrodynamics, multiphase flows, and particle accelerators. In particular, the AMReX-Astro GitHub repository holds a number of astrophysical modeling tools based on AMReX. The origins of AMReX trace back to the BoxLib software framework. AMReX supports a number of different time-stepping strategies and spatial discretizations. Solution strategies supported by AMReX range from level-by-level approaches (with or without subcycling in time) with multilevel synchronization to full-hierarchy approaches, and any combination thereof. User-defined kernels that operate on patches of data can be written in C++ or Fortran; there is also a Fortran-interface functionality which wraps the core C++ data structures and operations in Fortran wrappers so that an application code based on AMReX can be written entirely in Fortran.},
doi = {10.21105/joss.01370},
journal = {Journal of Open Source Software},
number = 37,
volume = 4,
place = {United States},
year = {Sun May 12 00:00:00 EDT 2019},
month = {Sun May 12 00:00:00 EDT 2019}
}

Works referenced in this record:

Meeting the Challenges of Modeling Astrophysical Thermonuclear Explosions: Castro, Maestro, and the AMReX Astrophysics Suite
journal, May 2018


Adaptive mesh refinement for hyperbolic partial differential equations
journal, March 1984


Local adaptive mesh refinement for shock hydrodynamics
journal, May 1989


Three-Dimensional Adaptive Mesh Refinement for Hyperbolic Conservation Laws
journal, January 1994

  • Bell, John; Berger, Marsha; Saltzman, Jeff
  • SIAM Journal on Scientific Computing, Vol. 15, Issue 1
  • DOI: 10.1137/0915008

A Conservative Adaptive Projection Method for the Variable Density Incompressible Navier–Stokes Equations
journal, May 1998

  • Almgren, Ann S.; Bell, John B.; Colella, Phillip
  • Journal of Computational Physics, Vol. 142, Issue 1
  • DOI: 10.1006/jcph.1998.5890

An Adaptive Projection Method for Unsteady, Low-Mach Number Combustion
journal, December 1998

  • Pember, R. B.; Howell, L. H.; Bell, J. B.
  • Combustion Science and Technology, Vol. 140, Issue 1-6
  • DOI: 10.1080/00102209808915770

BoxLib with Tiling: An Adaptive Mesh Refinement Software Framework
journal, January 2016

  • Zhang, Weiqun; Almgren, Ann; Day, Marcus
  • SIAM Journal on Scientific Computing, Vol. 38, Issue 5
  • DOI: 10.1137/15M102616X

SUNDIALS: Suite of nonlinear and differential/algebraic equation solvers
journal, September 2005

  • Hindmarsh, Alan C.; Brown, Peter N.; Grant, Keith E.
  • ACM Transactions on Mathematical Software, Vol. 31, Issue 3
  • DOI: 10.1145/1089014.1089020

ParaView: An End-User Tool for Large-Data Visualization
book, January 2005


yt: A MULTI-CODE ANALYSIS TOOLKIT FOR ASTROPHYSICAL SIMULATION DATA
journal, December 2010

  • Turk, Matthew J.; Smith, Britton D.; Oishi, Jeffrey S.
  • The Astrophysical Journal Supplement Series, Vol. 192, Issue 1
  • DOI: 10.1088/0067-0049/192/1/9

A Multigrid Tutorial, Second Edition
book, January 2000

  • Briggs, William L.; Henson, Van Emden; McCormick, Steve F.
  • Other Titles in Applied Mathematics
  • DOI: 10.1137/1.9780898719505

A Multi-Code Analysis Toolkit for Astrophysical Simulation Data
text, January 2010


Works referencing / citing this record:

An embedded boundary approach for efficient simulations of viscoplastic fluids in three dimensions
journal, September 2019

  • Sverdrup, Knut; Almgren, Ann; Nikiforakis, Nikolaos
  • Physics of Fluids, Vol. 31, Issue 9
  • DOI: 10.1063/1.5110654

A new approach for phase field modeling of grain boundaries with strongly nonconvex energy
journal, October 2019

  • Ribot, Josep Gras; Agrawal, Vinamra; Runnels, Brandon
  • Modelling and Simulation in Materials Science and Engineering, Vol. 27, Issue 8
  • DOI: 10.1088/1361-651x/ab47a0

MAESTROeX: A Massively Parallel Low Mach Number Astrophysical Solver
journal, November 2019

  • Fan, Duoming; Nonaka, Andrew; Almgren, Ann
  • Journal of Open Source Software, Vol. 4, Issue 43
  • DOI: 10.21105/joss.01757

Improved Coupling of Hydrodynamics and Nuclear Reactions via Spectral Deferred Corrections
journal, November 2019


MAESTROeX: A Massively Parallel Low Mach Number Astrophysical Solver
journal, December 2019

  • Fan, Duoming; Nonaka, Andrew; Almgren, Ann S.
  • The Astrophysical Journal, Vol. 887, Issue 2
  • DOI: 10.3847/1538-4357/ab4f75

An embedded boundary approach for efficient simulations of viscoplastic fluids in three dimensions
text, January 2019


MAESTROeX: A Massively Parallel Low Mach Number Astrophysical Solver
text, January 2019


PICSAR-QED: a Monte Carlo module to simulate strong-field quantum electrodynamics in particle-in-cell codes for exascale architectures
journal, February 2022

  • Fedeli, Luca; Zaïm, Neïl; Sainte-Marie, Antonin
  • New Journal of Physics, Vol. 24, Issue 2
  • DOI: 10.1088/1367-2630/ac4ef1

Exascale applications: skin in the game
journal, January 2020

  • Alexander, Francis; Almgren, Ann; Bell, John
  • Philosophical Transactions of the Royal Society A: Mathematical, Physical and Engineering Sciences, Vol. 378, Issue 2166
  • DOI: 10.1098/rsta.2019.0056

AMReX: Block-structured adaptive mesh refinement for multiphysics applications
journal, June 2021

  • Zhang, Weiqun; Myers, Andrew; Gott, Kevin
  • The International Journal of High Performance Computing Applications
  • DOI: 10.1177/10943420211022811