infomeasure 0.6.2

[!IMPORTANT] ⚡ Rust implementation now in beta! All core measures have been reimplemented in infomeasure-rs (crate docs) with compile-time type safety, GPU acceleration, and even faster execution. Check out the Rust Guide if you need maximum performance for production or large-scale analysis. Find the benchmark and interactive Rust vs Python performance comparison here.

Continuous and discrete entropy and information measures using different estimation techniques.

For details on how to use this package, see the Guide or the Documentation.

Setup

This package can be installed from PyPI using pip:

pip install infomeasure

This will automatically install all the necessary dependencies as specified in the pyproject.toml file. It is recommended to use a virtual environment, e.g. using conda, mamba or micromamba (they can be used interchangeably). infomeasure can be installed from the conda-forge channel.

conda create -n im_env -c conda-forge python
conda activate im_env
conda install -c conda-forge infomeasure

Development Setup

For development, we recommend using micromamba to create a virtual environment (conda or mamba also work) and installing the package in editable mode. After cloning the repository, navigate to the root folder and create the environment with the desired python version and the dependencies.

micromamba create -n im_env -c conda-forge python
micromamba activate im_env

To let micromamba handle the dependencies, use the requirements files

micromamba install -f requirements/build_requirements.txt \
  -f requirements/linter_requirements.txt \
  -f requirements/test_requirements.txt \
  -f requirements/doc_requirements.txt
pip install --no-build-isolation --no-deps -e .

Alternatively, if you prefer to use pip, installing the package in editable mode will also install the development dependencies.

pip install -e ".[all]"

Now, the package can be imported and used in the python environment, from anywhere on the system if the environment is activated. For new changes, the repository only needs to be updated, but the package does not need to be reinstalled.

Set up Jupyter kernel

If you want to use infomeasure with its environment im_env in Jupyter, run:

pip install --user ipykernel
python -m ipykernel install --user --name=im_env

This allows you to run Jupyter with the kernel im_env (Kernel > Change Kernel > im_env)

Acknowledgments

This project has received funding from the European Research Council (ERC) under the European Union's Horizon 2020 research and innovation programme (grant agreement No 851255). This work was partially supported by the María de Maeztu project CEX2021-001164-M funded by the MICIU/AEI/10.13039/501100011033 and FEDER, EU.