Metadata-Version: 2.4
Name: pybinny
Version: 0.2.0
Summary: Flexible tomographic binning algorithms for cosmology.
Author-email: Nikolina Sarcevic <nikolina.sarcevic@gmail.com>
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy
Requires-Dist: pyyaml
Requires-Dist: scipy
Requires-Dist: cmasher
Provides-Extra: dev
Requires-Dist: bump-my-version>=0.26; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov>=5; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: tox>=4.22; extra == "dev"
Provides-Extra: docs
Requires-Dist: sphinx[doctest]<9; extra == "docs"
Requires-Dist: sphinx-copybutton; extra == "docs"
Requires-Dist: sphinx-design; extra == "docs"
Requires-Dist: sphinx-multiversion; extra == "docs"
Requires-Dist: sphinxawesome-theme; extra == "docs"
Requires-Dist: furo; extra == "docs"
Dynamic: license-file

<p align="center">
  <img src="docs/_static/animations/binny_logo.gif" width="220">
</p>

# binny

<p align="center">

[![CI](https://github.com/binny-org/binny/actions/workflows/ci.yml/badge.svg)](https://github.com/binny-org/binny/actions/workflows/ci.yml)
[![Deploy Sphinx Documentation](https://github.com/binny-org/binny/actions/workflows/docs.yml/badge.svg)](https://github.com/binny-org/binny/actions/workflows/docs.yml)
[![codecov](https://codecov.io/gh/binny-org/binny/branch/main/graph/badge.svg)](https://codecov.io/gh/binny-org/binny)
[![License](https://img.shields.io/github/license/binny-org/binny)](LICENSE)
[![Documentation](https://img.shields.io/badge/docs-binny-fde725?style=for-the-badge)](https://binny-org.github.io/binny)


</p>

**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

```bash
pip install pybinny
````

### Install from source
```bash
git clone https://github.com/binny-org/binny.git
cd binny
python -m pip install -e .
```

### Development install

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

---


# Citation

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

```bibtex
@software{sarcevic2026binny,
  title   = {binny: Flexible binning algorithms for cosmology},
  author  = {Šarčević, Nikolina and van der Wild, Matthijs},
  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

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

