Forward Modeling of Large-Scale Structure: An open-source approach with Halotools

Abstract

We present the first stable release of Halotools (v0.2), a community-driven Python package designed to build and test models of the galaxy-halo connection. Halotools provides a modular platform for creating mock universes of galaxies starting from a catalog of dark matter halos obtained from a cosmological simulation. The package supports many of the common forms used to describe galaxy-halo models: the halo occupation distribution (HOD), the conditional luminosity function (CLF), abundance matching, and alternatives to these models that include effects such as environmental quenching or variable galaxy assembly bias. Satellite galaxies can be modeled to live in subhalos, or to follow custom number density profiles within their halos, including spatial and/or velocity bias with respect to the dark matter profile. The package has an optimized toolkit to make mock observations on a synthetic galaxy population, including galaxy clustering, galaxy-galaxy lensing, galaxy group identification, RSD multipoles, void statistics, pairwise velocities and others, allowing direct comparison to observations. Halotools is object-oriented, enabling complex models to be built from a set of simple, interchangeable components, including those of your own creation. Halotools has an automated testing suite and is exhaustively documented on http://halotools.readthedocs.io, which includes quickstart guides, source code notes and a large collection of tutorials. The documentation is effectively an online textbook on how to build and study empirical models of galaxy formation with Python.

Revisions match version accepted for publication in AAS

References in corpus (5)

• A universal model for halo concentrations
• Towards a Concordant Model of Halo Occupation Statistics
• On the Lack of Evolution in Galaxy Star Formation Efficiency
• A 2.5% measurement of the growth rate from small-scale redshift space clustering of SDSS-III CMASS galaxies
• CLASS: The Cosmology Large Angular Scale Surveyor

Cited by in corpus (100)

• The Astropy Project: Building an inclusive, open-science project and status of the v2.0 core package
• UniverseMachine: The Correlation between Galaxy Growth and Dark Matter Halo Assembly from z=0-10
• COLOSSUS: A python toolkit for cosmology, large-scale structure, and dark matter halos
• nbodykit: an open-source, massively parallel toolkit for large-scale structure
• Corrfunc --- A Suite of Blazing Fast Correlation Functions on the CPU
• The Clustering of DESI-like Luminous Red Galaxies Using Photometric Redshifts
• Large-scale dark matter simulations
• CosmoDC2: A Synthetic Sky Catalog for Dark Energy Science with LSST
• The Abacus Cosmos: A Suite of Cosmological N-body Simulations
• AbacusHOD: A highly efficient extended multi-tracer HOD framework and its application to BOSS and eBOSS data
• The Completed SDSS-IV extended Baryon Oscillation Spectroscopic Survey: exploring the Halo Occupation Distribution model for Emission Line Galaxies
• An extended halo around an ancient dwarf galaxy
• Tangos: the agile numerical galaxy organization system
• Five-percent measurements of the growth rate from simulation-based modelling of redshift-space clustering in BOSS LOWZ
• The Galaxy Clustering Crisis in Abundance Matching
• The Swift/BAT AGN Spectroscopic Survey -- IX. The Clustering Environments of an Unbiased Sample of Local AGN
• First results from the JWST Early Release Science Program Q3D: Turbulent times in the life of a $z\sim 3$ extremely red quasar revealed by NIRSpec IFU
• GalaxyNet: Connecting galaxies and dark matter haloes with deep neural networks and reinforcement learning in large volumes
• ALMA measures rapidly depleted molecular gas reservoirs in massive quiescent galaxies at z~1.5
• Weak Lensing Reveals a Tight Connection Between Dark Matter Halo Mass and the Distribution of Stellar Mass in Massive Galaxies
• A machine learning approach to mapping baryons onto dark matter haloes using the EAGLE and C-EAGLE simulations
• How Accurately Can We Detect the Splashback Radius of Dark Matter Halos and its Correlation With Accretion Rate?
• Correlations between Triaxial Shapes and Formation History of Dark Matter Haloes
• New perspectives on the BOSS small-scale lensing discrepancy for the Planck $\Lambda$CDM Cosmology
• The Completed SDSS-IV Extended Baryon Oscillation Spectroscopic Survey: N-body Mock Challenge for Galaxy Clustering Measurements
• Dark Energy Survey Year 3 results: cosmology from combined galaxy clustering and lensing -- validation on cosmological simulations
• Updated Results on the Galaxy-Halo Connection from Satellite Kinematics in SDSS
• On the halo-mass and radial scale dependence of the lensing is low effect
• Physical Correlations of the Scatter between Galaxy Mass, Stellar Content, and Halo Mass
• AI-assisted super-resolution cosmological simulations II: Halo substructures, velocities and higher order statistics
• Galaxy sizes and the galaxy-halo connection -- I: the remarkable tightness of the size distributions
• Constraints on $S_8$ from a full-scale and full-shape analysis of redshift-space clustering and galaxy-galaxy lensing in BOSS
• How are galaxies assigned to halos? Searching for assembly bias in the SDSS galaxy clustering
• Discovery and analysis of low-surface-brightness galaxies in the environment of NGC 1052
• Phase-space correlation in stellar streams of the Milky Way halo: The clash of Kshir and GD-1
• Void Galaxies Follow a Distinct Evolutionary Path in the Environmental COntext Catalog
• Towards Accurate Modelling of Galaxy Clustering on Small Scales: Testing the Standard $\Lambda \mathrm{CDM}$ + Halo Model
• How to Optimally Constrain Galaxy Assembly Bias: Supplement Projected Correlation Functions with Count-in-cells Statistics
• The completed SDSS-IV extended Baryon Oscillation Spectroscopic Survey: measurement of the growth rate of structure from the small-scale clustering of the luminous red galaxy sample
• The AGN-galaxy-halo connection: The distribution of AGN host halo masses to z=2.5
• The impact of Lyman-$\alpha$ radiative transfer on large-scale clustering in the Illustris simulation
• Can Assembly Bias Explain the Lensing Amplitude of the BOSS CMASS Sample in a Planck Cosmology?
• The GOGREEN survey: Dependence of galaxy properties on halo mass at z > 1 and implications for environmental quenching
• SHAPing the Gas: Understanding Gas Shapes in Dark Matter Haloes with Interpretable Machine Learning
• Diffstar: A Fully Parametric Physical Model for Galaxy Assembly History
• Evidence of Galaxy Assembly Bias in SDSS DR7 Galaxy Samples from Count Statistics
• The Uchuu-UniverseMachine dataset: Galaxies in and around Clusters
• Generating Synthetic Cosmological Data with GalSampler
• Stellar and Weak Lensing Profiles of Massive Galaxies in the Hyper-Suprime Cam Survey and in Hydrodynamic Simulations
• The Outer Stellar Mass of Massive Galaxies: A Simple Tracer of Halo Mass with Scatter Comparable to Richness and Reduced Projection Effects
• Beyond Ultra-diffuse Galaxies. I. Mass--Size Outliers among the Satellites of Milky Way Analogs
• The Clustering of X-ray Luminous Quasars
• TARDIS Paper II: Synergistic Density Reconstruction from Lyman-alpha Forest and Spectroscopic Galaxy Surveys with Applications to Protoclusters and the Cosmic Web
• The Aemulus Project VI: Emulation of beyond-standard galaxy clustering statistics to improve cosmological constraints
• Dark Matter and HI in Ultra-Diffuse Galaxy UGC 2162
• Radiative Transfer Distortions of Lyman-$\alpha$ Emitters: a New Fingers-of-God Damping in the Clustering in Redshift Space
• Main Sequence Scatter is Real: The Joint Dependence of Galaxy Clustering on Star Formation and Stellar Mass
• Maturing Satellite Kinematics into a Competitive Probe of the Galaxy-Halo Connection
• Clustering Constraints on the Relative Sizes of Central and Satellite Galaxies
• BASS. XXXVI. Constraining the Local Supermassive Black Hole - Halo Connection with BASS DR2 AGN
• Measuring the scale dependence of intrinsic alignments using multiple shear estimates
• Deep+Wide Lensing Surveys will Provide Exquisite Measurements of the Dark Matter Halos of Dwarf Galaxies
• Calibrating the cosmic distance ladder using gravitational-wave observations
• Galaxies and Halos on Graph Neural Networks: Deep Generative Modeling Scalar and Vector Quantities for Intrinsic Alignment
• Compact groups from semi-analytical models of galaxy formation -- I: a comparative study of frequency and nature
• Anisotropic Satellite Galaxy Quenching: A Unique Signature of Energetic Feedback by Supermassive Black Holes?
• Intrinsic alignments of bulges and discs
• The Beyond-Halo Mass Effects of the Cosmic Web Environment on Galaxies
• Fast Correlation Function Calculator -- A high-performance pair counting toolkit
• Galaxy Clustering in the Mira-Titan Universe I: Emulators for the redshift space galaxy correlation function and galaxy-galaxy lensing
• Testing the Impact of Satellite Anisotropy on Large and Small Scale Intrinsic Alignments using Hydrodynamical Simulations
• BASILISK: Bayesian Hierarchical Inference of the Galaxy-Halo Connection using Satellite Kinematics--I. Method and Validation
• Beyond Ultra-diffuse Galaxies. II. Environmental Quenching of Mass-Size Outliers among the Satellites of Milky Way Analogs
• Validating the clustering predictions of empirical models with the FLAMINGO simulations
• Towards an accurate model of small-scale redshift-space distortions in modified gravity
• Fast analytical calculation of the random pair counts for realistic survey geometry
• A New Stellar Mass Proxy for Subhalo Abundance Matching
• PRIMUS: Clustering of Star-forming and Quiescent Central Galaxies at $0.2<z<0.9$
• EMERGE: Constraining merging probabilities and timescales of close galaxy pairs
• Tests of Acoustic Scale Shifts in Halo-based Mock Galaxy Catalogues
• SCONCE: A cosmic web finder for spherical and conic geometries
• Beyond Mass: Detecting Secondary Halo Properties with Galaxy-Galaxy Lensing
• Finding proto-clusters to trace galaxy evolution: I. The finder and its performance
• Why do semi-analytic models predict higher scatter in the stellar mass-halo mass relation than cosmological hydrodynamic simulations?
• ScamPy -- A sub-halo clustering & abundance matching based Python interface for painting galaxies on the dark matter halo/sub-halo hierarchy
• DESI Mock Challenge: Constructing DESI galaxy catalogues based on FastPM simulations
• Signature of Massive Neutrinos from the Clustering of Critical Points. I. Density-threshold-based Analysis in Configuration Space
• The impact of AGN X-ray selection on the AGN halo occupation distribution
• Improving Galaxy Cluster Selection with the Outskirt Stellar Mass of Galaxies
• Assembly Conformity of Structure Growth: Fossil versus Normal Groups of Galaxies
• FLAMINGO: Galaxy formation and feedback effects on the gas density and velocity fields
• Bounds on galaxy stochasticity from halo occupation distribution modeling
• Improving the Accuracy of Halo Mass Based Statistics For Fast Approximate N-body Simulations
• The Jet Paths of Radio AGN and their Cluster Weather
• Constraining Galaxy-Halo Connection Using Machine Learning
• Galaxy assembly bias in cosmological hydrodynamical simulations: a comparison between SIMBA and IllustrisTNG
• Fuzzy dark matter dynamical friction: stalling of globular clusters induced by dynamical heatings
• Intrinsic alignments of galaxies in multiple projections
• SDSS-IV MaNGA: A Catalogue of Spectroscopically Detected Strong Galaxy-Galaxy Lens Candidates
• CellListMap.jl: Efficient and customizable cell list implementation for calculation of pairwise particle properties within a cutoff