binny

binny is a Python library for constructing and analyzing
tomographic redshift bins used in cosmology and large-scale structure analyses.

It provides flexible binning algorithms, validation utilities, and diagnostic tools for forecasting, inference pipelines, and survey analysis workflows.

Installation

Install from PyPI

pip install pybinny

Install from source

git clone https://github.com/binny-org/binny.git
cd binny
python -m pip install -e .

Development install

python -m pip install -e ".[dev]"

Citation

If you use binny in your research, please cite it.

@software{sarcevic2026binny,
  title   = {binny: Flexible binning algorithms for cosmology},
  author  = {Šarčević, Nikolina and van der Wild, Matthijs and Polen, Rebekah},
  year    = {2026},
  url     = {https://github.com/binny-org/binny}
}

Citation metadata is also available in CITATION.cff, which GitHub uses to generate citation formats automatically.

Contributing

Contributions are very welcome. See the Contributing guide in the documentation for development workflow, testing, and code style guidelines.

License

and:

MIT License © 2026 Nikolina Šarčević, Matthijs van der Wild, Rebekah Polen, and contributors.