Metadata-Version: 2.4
Name: confusius
Version: 0.0.1a2
Summary: Python package for analysis and visualization of functional ultrasound imaging data.
Author: Samuel Le Meur-Diebolt
Author-email: Samuel Le Meur-Diebolt <samuel@diebolt.io>
License-Expression: BSD-3-Clause AND Apache-2.0
License-File: LICENSE-Apache-2.0
License-File: LICENSE-BSD-3-Clause
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Image Processing
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Typing :: Typed
Requires-Dist: dask[complete]>=2025.9.0
Requires-Dist: h5py>=3.15.1
Requires-Dist: ipython>=9.6.0
Requires-Dist: joblib>=1.5.2
Requires-Dist: joblib-progress>=1.0.6
Requires-Dist: matplotlib>=3.10.7
Requires-Dist: napari[all]>=0.6.6
Requires-Dist: nibabel>=5.0.0
Requires-Dist: numpy>=2.3.4
Requires-Dist: rich>=14.2.0
Requires-Dist: scikit-learn>=1.5.0
Requires-Dist: scipy>=1.16.3
Requires-Dist: simpleitk>=2.5.3
Requires-Dist: xarray[complete]>=2025.1.0
Requires-Dist: zarr>=3.1.3
Requires-Python: >=3.13
Description-Content-Type: text/markdown

![PyPI version](https://img.shields.io/pypi/v/confusius)
![Python versions](https://img.shields.io/pypi/pyversions/confusius)
![License](https://img.shields.io/pypi/l/confusius)
[![DOI](https://zenodo.org/badge/1155356116.svg)](https://doi.org/10.5281/zenodo.18611124)
[![codecov](https://codecov.io/github/sdiebolt/confusius/graph/badge.svg?token=TL5AIRNSHS)](https://codecov.io/github/sdiebolt/confusius)

# ConfUSIus

> [!WARNING]
> ConfUSIus is currently in pre-alpha and under active development. The API is subject
> to change, and features may be incomplete or unstable.

ConfUSIus is a Python package for handling, visualization, preprocessing, and
statistical analysis of functional ultrasound imaging (fUSI) data.

## Installation

### 1. Setup a virtual environment

We recommend that you install ConfUSIus in a virtual environment to avoid dependency
conflicts with other Python packages. Using
[uv](https://docs.astral.sh/uv/guides/install-python/), you may create a new project
folder with a virtual environment as follows:

```bash
uv init new_project
```

If you already have a project folder, you may create a virtual environment as follows:

```bash
uv venv
```

### 2. Install ConfUSIus

ConfUSIus is available on PyPI. Install it using:

```bash
uv add confusius
```

Or with pip:

```bash
pip install confusius
```

To install the latest development version from GitHub:

```bash
uv add git+https://github.com/sdiebolt/confusius.git
```

### 3. Check installation

Check that ConfUSIus is correctly installed by opening a Python interpreter and
importing the package:

```python
import confusius
```

If no error is raised, you have installed ConfUSIus correctly.
