BlendingToolKit

Summary

Framework for fast generation and analysis of galaxy blends catalogs. This toolkit is a convenient way of producing multi-band postage stamp images of blend scenes.

Documentation can be found at https://lsstdesc.org/BlendingToolKit/index.html

Workflow

• In red are the BTK objects that can be customized in various ways by BTK users.

Running BlendingToolKit

• BlendingToolKit (btk) requires an input catalog that contains information required to simulate galaxies and blends. This repository includes sample input catalogs with a small number of galaxies that can be used to draw blend images with btk. See tutorials to learn how to run btk with these catalogs.
• CatSim Catalog corresponding to one square degree of sky and processed WeakLensingDeblending catalogs can be downloaded from here.
• Cosmo DC2 catalog requires pre-processing in order to be used as input catalog to btk. Refer to this notebook on how to convert the DC2 catalog into a CatSim-like catalog that can be analyzed with btk.

Installation

BTK is pip installable, with the following command:

pip install blending_toolkit

Although you might run into problems installing galsim. In case of any issues, please see the more detailed installation instructions here.

For required packages, see pyproject.toml under the [tool.poetry.dependencies] block. For developers, you will also need the packages under the [tool.poetry.dev-dependencies] block.

Tutorial

You can check out our introduction tutorial and get acquainted with BTK in a binder instance (no installation required) by simply clicking here.

Contributing

See CONTRIBUTING.md