MAESTROeX | A C++ low Mach number stellar hydrodynamics code

MAESTROeX requires a C++ compiler that supports the C++11 standard, a Fortran compiler that supports the Fortran 2003 standard, and a C compiler that supports the C99 standard. Several compiler suites are supported, including GNU, Intel, PGI and Cray. GNU Make (>= 3.82) is also required, as is Python (>= 3.6) and standard tools available in any Unix-like environments (e.g., Perl and sed). For GPU computing, CUDA 10 or later is requred. To stay up-to-date with MAESTROeX, you will want to periodically pull changes from the repository by typing git pull. To get things running, you will need to get a copy of Microphysics and AMReX. Both are available on github separately or as submodules.
MAESTROeX requires a C++ compiler that supports the C++11 standard, a Fortran compiler that supports the Fortran 2003 standard, and a C compiler that supports the C99 standard. Several compiler suites are supported, including GNU, Intel, PGI and Cray. GNU Make (>= 3.82) is also required, as is Python (>= 3.6) and standard tools available in any Unix-like environments (e.g., Perl and sed). For GPU computing, CUDA 10 or later is requred.
To stay up-to-date with MAESTROeX, you will want to periodically pull changes from the repository by typing git pull.
To get things running, you will need to get a copy of Microphysics and AMReX. Both are available on github separately or as submodules. To clone MAESTROeX with the submodules, do: git clone --recursive https://github.com/AMReX-Astro/MAESTROeX.git To add the submodules to an exisiting clone, from the top-level MAESTROeX directory, do: git submodule update --init --recursive If you want to get the AMReX and Microphysics separately, they can be directly cloned as: git clone https://github.com/AMReX-Astro/Microphysics.git git clone https://github.com/AMReX-Codes/amrex.git
You will then need to setup your shell environment to tell MAESTROeX where to find AMReX and Microphysics. Define the AMREX_HOME environment variable to point to the amrex/ directory, and MICROPHYSICS_HOME environment variable to point to the Microphysics/ directory. For example, if your shell is Bash: export AMREX_HOME="/path/to/amrex/" export MICROPHYSICS_HOME='/path/to/Microphysics" Note: you must specify the full path to the directories. Do not use ∼ to refer to your home directory; the scripts used by the build system will not be able to process this.
Change directory to correspond to the problem that you want to run. Each problem lives under one of three sub-directories of MAESTROeX/Exec/: SCIENCE/, TEST_PROBLEMS/, or UNIT_TESTS/. Then build the executable and run it by specifying an input file. For example, to run the standard reacting_bubble problem in 2-D: cd MAESTROeX/Exec/TEST_PROBLEMS/reacting_bubble/ make DIM=2 ./Maestro2d.gnu.ex inputs_2d_C
The plotfiles (named pltXXXXXXX) are in BoxLib/AMReX format and can be visualized using yt, Amrvis, and VisIt.