Metadata-Version: 2.4
Name: adele-plot
Version: 0.1.0
Summary: ADeLe plotting utilities for radial response visualizations.
Project-URL: Repository, https://github.com/aauss/adele-plot
Project-URL: Issues, https://github.com/aauss/adele-plot/issues
Author-email: Auss Abbood <contact@aussabbood.com>
License-Expression: MIT
License-File: LICENSE
Keywords: adele,matplotlib,plotting,visualization
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.12
Requires-Dist: matplotlib>=3.8
Requires-Dist: numpy>=1.26
Requires-Dist: pandas>=2.2
Provides-Extra: dev
Requires-Dist: build>=1.2.2; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: twine>=6.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# adele-plot

Reusable plotting package for ADeLe radial response plots.

## Install

```bash
pip install adele-plot
```

## Input format

`plot_response_pie(...)` accepts either:

- wide `pandas.DataFrame` where each capability is a column and each cell is a demand level, or
- a pre-aggregated matrix with shape `(6, n_capabilities)` (`levels x capabilities`).

## Quickstart

```python
from adele_plot import DEFAULT_CAPABILITIES, plot_response_pie

result = plot_response_pie(df, title="ADeLe Response Pie", add_colorbar=True)
```

Default capabilities are:

```python
DEFAULT_CAPABILITIES = (
    "AS", "CEc", "CEe", "CL", "MCr", "MCt", "MCu", "MS", "QLl",
    "QLq", "SNs", "KNa", "KNc", "KNf", "KNn", "KNs", "AT", "VO",
)
```

For DataFrame input, if `capabilities` is not provided, the function automatically uses
the intersection of DataFrame columns and `DEFAULT_CAPABILITIES` in that exact order.

## Development

```bash
uv sync --extra dev
uv run pytest
uv run python -m build
uv run twine check dist/*
```

