v1.0.0 — 2025-12-04

Overview:

crow is a standalone Python package and DESC tool developed as part of the LSST-DESC collaboration for cluster observables evaluation. It provides a modular code base for cluster modeling, enabling computation of cluster abundance, cluster lensing profiles, and flexible recipe definitions for analysis of galaxy clusters.

This release packages the core clustering functionality currently present in the repository, providing a clean, ready-to-use set of tools for cluster modeling and analysis.

What’s included in this release:

Cluster modeling module: crow/models/cluster/ — encompasses cluster properties, profiles, mass-observable relations, selection functions, and modeling routines. Includes all code necessary to compute Cluster Lensing or Cluster Abundance.
Cluster properties configuration: crow/properties.py allows users to specify which cluster properties to compute.
Flexible recipe options: integration-based and grid-interpolation recipes are available in crow/recipes/. Integration recipes perform full profile integrals; grid recipes offer faster computation alternatives.
Example scripts / test infrastructure: includes example setups (grid vs integration recipes) and tests, enabling users to validate computations and run sample configurations.

Known limitations & future work:

Documentation is minimal: no comprehensive API reference, usage examples, or tutorials — this will be addressed in future updates.
The purity option does not work with the integration-based recipe (ExactBinnedClusterRecipe).
The miscentering option does not work with the vectorized shear computation and is not fully supported for all cluster configurations, i.e., should not be used in the recipes.
Plans for future releases include expanded examples, detailed documentation, and more robust testing.

Installation:

pip install desc-crow