Massively Parallel Cosmological SPH Simulation Software - MP-Gadget.
Source code browser (maybe slightely out-sync from current master branch)
This version of Gadget is derived from main P-Gadget / Gadget-2. It is the source code used to run the BlueTides simulation (http://bluetides-project.org).
The infrastructure is heavily reworked. As a summary:
- A better PM solver for long range force with Pencil FFT.
- A better Tree solver with faster threading and less redundant code.
- A better Domain decomposition that scales to half a million cores.
- A easier to use IO module with a Python binding.
- A more intuitive parameter file parser with schema and docstrings.
- A cleaner code base with less conditional compilation flags.
Physics models:
- Pressure Entropy SPH and Density Entropy SPH
- Radiation background in the expansion
- Massive neutrinos
- Dark energy
- ICs have species dependent density and velocity transfer functions
- Generic tracer particle seeding
- Various wind feedback and blackhole feedback models
- Various star formation criteria
- Primordial and metal cooling
- Fluctuating UV background
First time users:
git clone https://github.com/bluetides-project/MP-Gadget
# or git clone https://github.com/rainwoodman/MP-Gadget-private
cd MP-Gadget
bash bootstrap.shWe will need gsl. On HPC systems with the modules command, usually it can be loaded with
module load gsl
env | grep GSL # check if GSL path is reasonableOn a common PC/Linux system, refer to your package vendor how to install gsl and gsl-devel.
Copy Options.mk.example to Options.mk
cp Options.mk.example Options.mkEdit Options.mk
- Set GSL flags according to the environment variables. On coma, use Options.mk.example.coma.
- Tweak the compilation options for 'features'. We are in the process of cleaning this up. Most options are tricky and undocumented, as Gadget. The defaults shall work for most cases; it enables Pressure-Entropy SPH and Blackhole, Cooling and SFR. To run a N-Body sim, use IC files with no gas particles.
- For off-tree build, set DESTDIR in Options.mk; the default target is in build/
Now we are ready to build
make -j 8It takes some time to build pfft, one of the bundled dependencies. Other libraries are bigfile and mp-sort, which are written by me and quick to build.
In the end, we will have 2 binaries:
ls build/MP-Gadget build/MP-GenIC
- MP-Gadget is the main simulation program.
- MP-GenIC is the initial condition generator.
Cray updated their GLIBC to 2.22+ recently. A good move but it happens to be a buggy version of GLIBC: https://sourceware.org/bugzilla/show_bug.cgi?id=19590 causing non-existing symbols like _ZGVcN4v___log_finite. Adding -lmvec -lmvec_nonshared to GSL_LIBS works around the issue.
Find examples in examples/.
- dm-only : Dark Matter only
- lya : Lyman Alpha only (needs special compilcation flags)
- hydro : hydro
- small : hydro with low resolution
When OpenMP is switched from on to off or off to on, all of the dependencies needs to be recompiled. This can be achived by removing all files in depends/lib.
Otherwise symbols related to OpenMP in PFFT may be missing.
Always enable OpenMP, and control number of threads with OMP_NUM_THREADS.
The snapshot is in bigfile format. For data analysis in Python, use
pip install bigfileRefer to https://github.com/rainwoodman/bigfile for usage.
Otherwise directly open the blocks with Fortran or C, noting the data-type information and attributes in header and attrs files (in plain text)
Gadget-2 was authored by Volker Springel. The original P-GADGET3 was maintained by Volker Springel
MP-Gadget is maintained by Yu Feng.
Contributors to MP-Gadget include:
Simeon Bird, Nicholas Battaglia, Nishikanta Khandai
We never get around to write a proper code paper on MP-Gadget.
For usage of the code, here is a DOI for this repository that you can cite
It helps us to keep track of uses.
Most files are licensed under GPLv2+.
Please refer to the source files for details.
master branch status:
