HAMeRS is a compressible Navier-Stokes/Euler solver with the patch-based adaptive mesh refinement (AMR) technique. The parallelization of the code and all the construction, management and storage of cells are facilitated by the Structured Adaptive Mesh Refinement Application Infrastructure (SAMRAI) from the Lawrence Livermore National Laboratory (LLNL).
The code consists of various explicit high-order finite difference shock-capturing WCNS's (Weighted Compact Nonlinear Schemes) for capturing shock waves, material interfaces, and turbulent features. The AMR algorithm implemented is based on the one developed by Berger et al.
Git is used for the version control of the code. To install Git on Debian-based distribution like Ubuntu, try apt-get:
sudo apt-get install git-all
To compile the code, in general all you need is to use CMake. For example, after cloning the repository with git clone:
cd HAMeRS
mkdir build
cd build
cmake ..
make
To run the code, you need to provide the input file:
src/exec/main <input filename>
To restart a simulation, you need to provide restart directory and restore number in addition to the input file:
src/exec/main <input filename> <restart dir> <restore number>
To run the code in parallel, you need MPI. You can try mpirun:
mpirun -np <number of processors> src/exec/main <input filename>
HAMeRS relies on HDF5, Boost and SAMRAI. Before installing HAMeRS, it is required to set up the environmental variables for CMake to look for the locations of the libraries.
To set up HDF5:
export HDF5_ROOT=<path to the directory of HDF5>
To set up Boost:
export BOOST_ROOT=<path to the directory of Boost>
To set up SAMRAI:
export SAMRAI_ROOT=<path to the directory of SAMRAI>
HAMeRS has already been successfully tested with HDF5-1.8, Boost-1.60 and SAMRAI-3.11.2.
To change the problem that you want to run for an application, e.g. the Euler application, just simply link the corresponding initial conditions cpp symlink (EulerInitialConditions.cpp in src/apps/Euler) to the actual problem file using ln -sf <absolute path to .cpp file containing problem's initial conditions> EulerInitialConditions.cpp. If the problem has special boundary conditions, the user can supply the boundary conditions with ln -sf <absolute path to .cpp file containing problem's user-coded boundary conditions> EulerSpecialBoundaryConditions.cpp. There are some initial conditions and boundary conditions files from different example problems in the problems folder.
The code is managed by Man-Long Wong (wongml@stanford.edu) of the Flow Physics and Aeroacoustics Laboratory (FPAL) at the Department of Aeronautics and Astronautics of Stanford University.
HAMeRS is licensed under a GNU Lesser General Public License v3.0.
Add PRESSURE_INFLOW and PRESSURE_OUTFLOW only for 2D and constantly populate farfield ghost nodes(first order) comments out the usage of getFaceLocationForEdgeBdry