Welcome to Galacticus

Welcome to the Galacticus project. Galacticus is a semi-analytic model of galaxy formation - a powerful toolkit for modeling the physics of how galaxies form. For more information please see the wiki, and for a description of the physics see the description paper on Galacticus.

Have questions? Ask them in the discussion forum.

---

Quickstart

This section walks you through building and running a minimal Galacticus model for the first time.

Prerequisites

Before building, make sure you have the following available:

• A modern Fortran compiler (e.g., gfortran ≥ 11)
• make
• HDF5 libraries (the code writes output in HDF5 format)
• FFTW3 libraries
• GSL (GNU Scientific Library)
• Perl (used by the build system for code generation)
• Python 3 (used by various scripts)

Tip: The easiest way to get a fully configured environment is to use GitHub Codespaces (click the badge above). All dependencies are pre-installed.

Building Galacticus

From the root of the repository, run:

make -jN Galacticus.exe

Replace N with the number of CPU cores you want to use in parallel (e.g., make -j4 Galacticus.exe to use 4 cores). Using multiple cores significantly speeds up the build. If you are unsure how many cores are available, you can run nproc on Linux to find out.

Running a minimal model

Once the build completes successfully, run the included quick-test parameter file:

./Galacticus.exe parameters/quickTest.xml

This runs a small, pre-configured galaxy formation model designed to complete quickly.

What to expect

A successful run will:

• Exit with code 0 (no error message printed to the terminal).
• Write output to the path specified by the outputFileName parameter inside parameters/quickTest.xml. By default this is an HDF5 file (.hdf5) in the working directory. Open that file to inspect the results (e.g., with h5ls or any HDF5 viewer).
• Print progress information to standard output during the run. The final line should indicate that the run completed without errors.

To find the output file path, inspect the outputFileName element near the top of parameters/quickTest.xml.

Troubleshooting

Problem	What to try
make: command not found	Install make (e.g., sudo apt install make on Debian/Ubuntu).
Compiler errors during build	Check that a supported Fortran compiler is installed and on your PATH.
Build hangs or fails with parallel jobs	Try removing the -jN flag and running make Galacticus.exe (single-threaded) to get clearer error output.
./Galacticus.exe: No such file or directory	The build did not complete successfully. Re-run make and check for errors.
Parameter file not found	Ensure you are running the command from the repository root directory so that parameters/quickTest.xml resolves correctly.
Missing library errors at link time	Verify that HDF5, FFTW3, and GSL development packages are installed and that their locations are on the relevant library paths.

For further help, visit the wiki or ask in the discussion forum.