galsbi 0.3.0

Package to easily generate catalogs from the model

The (Great) GalSBI

Create realistic galaxy catalogs and astronomical images based on the GalSBI model. The GalSBI phenomenological model is described in Fischbacher et al. (2024), while the stellar population synthesis-based model GalSBI-SPS in Tortorelli et al. (2025). The Python package is described in Fischbacher et al. (2024).

Motivation

Next-generation galaxy surveys will test cosmology with unprecedented precision. To fully realize the potential of these surveys, forward modeling of galaxy populations offers a promising path - enabling accurate redshift estimation, shape measurement calibration, selection effect modeling, and deeper insights into galaxy properties.

GalSBI is a parametric galaxy population model constrained by observational data using simulation-based inference (SBI). The galsbi Python package provides a flexible framework for generating realistic galaxy catalogs and rendering them into astronomical images via UFig.

Installation

The package can be installed via pip:

pip install galsbi

or using uv:

uv pip install galsbi

Usage

To generate a catalog of galaxies with their intrinsic properties from the phenomenological model, you can use the following code snippet:

from galsbi import GalSBI

model = GalSBI(name="Fischbacher+24") # define which model to use
model(mode="intrinsic") # generating catalogs with intrinsic galaxy properties
cats = model.load_catalogs() # load the generated catalogs

intrinsic_i_band_cat = cats["ucat galaxies i"]

To generate a catalog of galaxies with their intrinsic properties from the stellar population synthesis-based model GalSBI-SPS, you can use the following code snippet:

from galsbi import GalSBI

model = GalSBI("Tortorelli+25")
model(mode="intrinsic")
cats = model.load_catalogs()

intrinsic_i_band_cat = cats["ucat galaxies i"]

More examples and detailed documentation can be found in the documentation. Note: The first time you run galsbi, additional data files will be downloaded automatically and cached locally. The initial run may also take longer due to PyCosmo compilation. If you encounter any issues, see the FAQ.

Currently, the following models are available:

• Fischbacher+24: constrained in Fischbacher et al. (2024).
• Tortorelli+25: constrained in Tortorelli et al. (2025).
• Moser+24: constrained in Moser et al. (2024).

There are different modes available to generate catalogs:

• intrinsic: generates a catalog with intrinsic galaxy properties for HSC grizy bands.
• emulator: generates a catalog with intrinsic galaxy properties for HSC grizy bands and a catalog with measured galaxy properties for each band using an emulator trained on HSC deep fields.
• image: generates a catalog with intrinsic galaxy properties for HSC grizy bands and a simulated image for each band. The image has background noise and PSF size similar to HSC deep fields.
• image+SE: same as image, but also runs SExtractor on the images to generate catalogs with measured galaxy properties for each band.
• config_file: runs the model following a custom configuration file. The path to the configuration file can be passed as an argument config_file. The predefined configuration files can be found in the src/galsbi/configs directory and can be used as a starting point for custom configurations.

The loaded catalogs are stored in a dictionary with the following keys:

• ucat galaxies <band>: intrinsic galaxy catalog for the given band.
• ucat stars <band>: intrinsic star catalog for the given band.
• sextractor <band>: catalog with measured galaxy properties for the given band (if a measured catalog is generated)
• sed: catalog with SEDs of the galaxies (in case the SEDs are saved, see Saving Galaxy Spectra).
• restframe_wavelength_in_A: the restframe wavelength in Angstroms for the SEDs (if the SEDs are saved).

By default, the catalogs are loaded as structured NumPy arrays. Setting output_format to df loads them as pandas DataFrames, while output_format="fits" loads them as FITS catalogs. An overview of the columns in the catalogs can be found in the Catalog Column Descriptions.

If an image is generated, one can also load the images, segmentation and background maps using model.load_images(). This returns a dictionary with the following keys:

• image <band>: the simulated image for the given band.
• segmentation <band>: the segmentation map for the given band.
• background <band>: the background map for the given band.

More details on the usage of the package can be found in the documentation.

Citation

If you use GalSBI in your work, please cite the science papers Fischbacher et al. (2024), Tortorelli et al. (2025), the ProMage magnitude emulator paper Tortorelli et al. (2025b), and the code release paper Fischbacher et al. (2024). If you are using specific models or parametrizations, please also cite the corresponding papers. If you are not sure which papers to cite, use the following with your model instance:

model.cite()

Credits

This package was developed by the Cosmology group at ETH Zurich and updated by the ACAI group at LMU Munich. The package is currently maintained by Silvan Fischbacher and Luca Tortorelli.

Contributions

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

Please see the Contributing to galsbi documentation for more information on how to contribute.