Metadata-Version: 2.1
Name: unite_toolbox
Version: 0.1.5
Summary: A toolbox for practical applications of information theory.
Author-email: Manuel Álvarez Chaves <manuel.alvarezchaves@simtech.uni-stuttgart.de>, Anneli Guthke <anneli.guthke@simtech.uni-stuttgart.de>, Uwe Ehret <uwe.ehret@kit.edu>, Hoshin Gupta <hoshin@arizona.edu>
Maintainer-email: Manuel Álvarez Chaves <manuel.alvarezchaves@simtech.uni-stuttgart.de>
License: MIT License
Project-URL: Documentation, https://unite-toolbox.readthedocs.io/
Project-URL: Repository, https://github.com/manuel-alvarez-chaves/unite_toolbox
Project-URL: Team, https://www.simtech.uni-stuttgart.de/exc/research/junior-research-groups/statistical-model-data-integration/
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: numpy>=1.25.0
Requires-Dist: scipy>=1.12.0
Requires-Dist: tqdm>=4.66.2
Provides-Extra: dev
Requires-Dist: jupyterlab>=4.1.2; extra == "dev"
Requires-Dist: matplotlib>=3.8.3; extra == "dev"
Requires-Dist: numpy>=1.26.4; extra == "dev"
Requires-Dist: pandas>=2.2.1; extra == "dev"
Requires-Dist: pyarrow>=15.0.0; extra == "dev"
Requires-Dist: scipy>=1.12.0; extra == "dev"
Requires-Dist: tqdm>=4.66.2; extra == "dev"
Requires-Dist: xarray>=2024.2.0; extra == "dev"

# UNITE Toolbox
###  Unified diagnostic evaluation of physics-based, data-driven and hybrid hydrological models based on information theory

This repository contains code for the UNITE set of tools based on information theory for the diagnostic evaluation of hydrological models. In the UNITE tools we have functions to calculate different quantities used in information theory: entropy $H(X)$, Kullback-Leibler divergence $D_{KL}(p||q)$, mutual information $I(X; Y)$, using different methods. More specifically, the methods implemented are:

 - Kernel density based estimation (KDE)
 - Binning using histograms
 - *k*-nearest neighbor based estimation (*k*NN)

## Installation
Although the code is still highly experimental and in very active development, a release version is hosted in PyPI and can be installed using `pip`. Check the `pyproject.toml` for requirements. The current state of the toolbox can be installed directly from this repository using `git`.

```
pip install unite_toolbox
```

## How-to

In the folder `examples\` please find a tutorial on the general usage of the toolbox.

