Metadata-Version: 2.4
Name: sci-viz-utils
Version: 0.1.2
Summary: Shared lightweight scientific visualization and utility helpers
Author: Yichen Guo
Keywords: scientific visualization,matplotlib,image analysis,utilities
Classifier: Development Status :: 3 - Alpha
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
Classifier: Topic :: Scientific/Engineering :: Visualization
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: matplotlib>=3.5
Requires-Dist: numpy>=1.21
Provides-Extra: hdf5
Requires-Dist: h5py>=3.8; extra == "hdf5"
Provides-Extra: video
Requires-Dist: imageio>=2.30; extra == "video"
Requires-Dist: imageio-ffmpeg>=0.5; extra == "video"
Requires-Dist: opencv-python>=4.8; extra == "video"
Provides-Extra: notebook
Requires-Dist: ipykernel>=6; extra == "notebook"
Requires-Dist: notebook>=7; extra == "notebook"
Provides-Extra: dev
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: twine>=5; extra == "dev"

# sci-viz-utils

Shared lightweight scientific visualization and utility helpers used by
AFM-tools, XRD-utils, PlumeDynamics, RHEED-tools, and PFW-Analysis.

This package owns generic foundations only: figure layout, image grids,
scale bars, colorbar formatting, simple array normalization, lightweight HDF5
inspection, file discovery, and video writing. Domain-specific analysis and
domain-specific plotting entry points stay in their original packages.

Install locally while developing the surrounding packages:

```bash
pip install -e .
```

Import examples:

```python
from sci_viz_utils.figures import layout_fig, show_images, save_figure
from sci_viz_utils.arrays import normalize_data
```

See [`USAGE.md`](USAGE.md) for a fuller development and notebook guide.
