# What's New in *playNano* 0.1.0

**Release date:** 2025‑09‑17

Welcome to the first public release of *playNano*! This version introduces a complete workflow for
**loading, processing, exploring, exporting, and analyzing** high‑speed AFM (HS‑AFM) video data—together with a
reproducible provenance model, notebooks, and full documentation.

## ✨ Highlights

- **AFM data loading & playback** from `.h5-jpk` and `.asd` files, and from folders containing `.spm` or `.jpk` files.
- **Processing pipeline** with masks and **complete provenance** (`stack.provenance`), storing per‑step outputs under
  keys like ``step_<n>_<name>``.
- **Export & re‑import**: save to **.h5** or **.npz** and reload later with **all stages, masks, and provenance preserved**.
- **GUI (PySide6)** with manual/auto **Z‑range** and **annotations/overlays** (timestamps, “RAW” label, scale bar).
- **Exports** to **OME‑TIFF** and **GIF** (optional scale bars) for sharing and presentations.
- **Analysis framework** with built‑in modules (LoG blobs, DBSCAN/K‑Means/X‑Means, particle tracking) and pluggable extensions.
- **Documentation & notebooks**: Sphinx site (User Guide, API, CLI) and example notebooks.

## 🧪 Processing & Provenance

- Sequential filters and masks (e.g., plane removal, row/median alignment, polynomial flattening, Gaussian smoothing).
- Each step records parameters, timestamps, and environment info in `stack.provenance`.
- Intermediate results are snapshotted and ordered as ``step_<n>_<name>`` for reliable comparison and debugging.

## 💾 Export & Re‑import

- Save current stack (data, stages, masks, provenance) to **HDF5 (`.h5`)** or **NumPy (`.npz`)** bundles.
- Reload bundles to continue processing or run analyses with **full history intact**.
- Export to **OME‑TIFF** for interoperability and **GIF** for rapid previews.

## 🖥️ GUI (PySide6)

- Real‑time playback, frame seeking, and snapshot previews.
- **Z‑range control**: auto or manual min/max for consistent visual scaling across frames.
- **Annotations/overlays**: timestamps, “RAW” label, and scale bar can be rendered on top of frames.
- Dark theme stylesheet for high‑contrast analysis.

## 📊 Analysis Framework

- Build pipelines from built‑in and pluggable modules.
- Included modules: LoG blob detection, DBSCAN/K‑Means/X‑Means clustering, and particle tracking.
- Outputs: labeled masks, per‑feature properties (area, min/max/mean, bbox, centroid), and per‑frame
  summaries—tracked in provenance.

## 🔧 CLI

Use the `playnano` command to run pipelines headless, export bundles, and create GIFs:

```bash
playnano process "path/to/jpk_folder" --channel height_trace \
  --processing-file processing.yaml --export tif,npz,h5 --make-gif