AlanPearl / mocksurvey

Some useful tools for conducting mock surveys of galaxies from the UniverseMachine empirical model.

mocksurvey

Some useful tools for conducting mock surveys of galaxies from the UniverseMachine empirical model.

Author

• Alan Pearl

Prerequisites

• python=3.9.* or python=3.8.*
• At the time of writing, a prerequisite (halotools>=0.7) is incompatible with python>=3.10.
• Optional, but recommended to install Corrfunc (pip install Corrfunc)
  • Requires gsl installation (check with gsl-config --version, install with conda install -c conda-forge gsl)

Example to automatically install prerequisites using a conda environment:

conda create -n py39-mocksurvey python=3.9 gsl
conda activate py39-mocksurvey
pip install Corrfunc

Note: If using pycorr, don't pip install Corrfunc. Instead, follow the pycorr instructions at https://py2pcf.readthedocs.io/en/latest/user/building.html

Installation and Getting Started

pip install --upgrade git+https://github.com/AlanPearl/mocksurvey.git

Set path to a directory where you would like to store downloaded data

• Make a directory, for example:

mkdir -p ~/local/mocksurvey_downloads/

• Set the path:

python -m mocksurvey set-data-path ~/local/mocksurvey_downloads

Download and install UniverseMachine source code

• Make a directory, for example:

mkdir -p ~/local/src/

• Install UniverseMachine:

cd ~/local/src
git clone https://bitbucket.org/pbehroozi/universemachine
cd universemachine
make
python -m mocksurvey config UM set-lightcone-executable ./lightcone

Download UniverseMachine snapshots. This redshift range (0 - inf) downloads all ~300 GB. You may choose a narrower range or enter a single value to download a single snapshot.

python -m mocksurvey download-um 0 inf

Download UltraVISTA photometry

python -m mocksurvey download-uvista

[Optional] Download raw synthetic spectra to assign to mock galaxies (~30 GB)

python -m mocksurvey download-uvista-mock-spectra

Get started by building a mock survey (see Pearl et al. 2022)

python -m mocksurvey lightcone [--help]

View all commands

python -m mocksurvey --help