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