Metadata-Version: 2.4
Name: ialdev-vis
Version: 0.2.0
Summary: iad.vis — visualization utilities (image grids, viewers, colormaps, matplotlib helpers)
Author: ipcoder
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: ialdev-core
Requires-Dist: ialdev-io
Requires-Dist: matplotlib>=3.5.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: regex>=2021.0.0
Requires-Dist: open3d>=0.15.0 ; extra == "3d"
Requires-Dist: ipyvolume>=0.6.0 ; extra == "3d"
Requires-Dist: ialdev-vis[graphviz, qt, jupyter, 3d, dev] ; extra == "all"
Requires-Dist: pytest>=7.0.0 ; extra == "dev"
Requires-Dist: pytest-cov>=3.0.0 ; extra == "dev"
Requires-Dist: pygraphviz>=1.14,<2 ; extra == "graphviz"
Requires-Dist: ipywidgets>=7.0.0 ; extra == "jupyter"
Requires-Dist: IPython>=7.0.0 ; extra == "jupyter"
Requires-Dist: PyQt5>=5.15.0 ; extra == "qt"
Requires-Dist: scikit-image>=0.19.0 ; extra == "qt"
Project-URL: Homepage, https://github.com/ipcoder/ialdev/tree/master/vis
Project-URL: Issues, https://github.com/ipcoder/ialdev/issues
Project-URL: Repository, https://github.com/ipcoder/ialdev
Provides-Extra: 3d
Provides-Extra: all
Provides-Extra: dev
Provides-Extra: graphviz
Provides-Extra: jupyter
Provides-Extra: qt

# ialdev-vis

Visualization utilities for the `iad` toolbox, published as `ialdev-vis` and imported as `iad.vis`.

Use this package for quick image grids, histograms, Matplotlib helpers, custom colormaps, interactive annotation widgets, Jupyter logging, and optional Qt/3D visualization tools.

## Install

```bash
pip install ialdev-vis
```

Optional extras:

```bash
pip install "ialdev-vis[qt]"
pip install "ialdev-vis[jupyter]"
pip install "ialdev-vis[3d]"
pip install "ialdev-vis[all]"
```

Requires Python `>=3.10`.

## Highlights

- `imgrid` and `imhist` for fast inspection of images and distributions.
- Matplotlib helpers for figure capture and conversion to arrays/PIL images.
- Built-in custom colormaps.
- Polygon-to-mask helpers and interactive ROI tools.
- Optional Qt image viewer and optional `ipyvolume`/Open3D 3D views.

## Examples

```python
from iad.vis import imgrid, imhist

imgrid(left_image, right_image, titles=["left", "right"], clim="auto")
imhist(left_image, right_image, titles=["left", "right"])
```

```python
from iad.vis.mpl_utils import fig2img

pil_image = fig2img(figure)
```

