Metadata-Version: 2.5
Name: bioimageflow-tracking-tools
Version: 0.2.0
Summary: Object extraction and lightweight tracking tools for BioImageFlow
Project-URL: Homepage, https://github.com/Inria-SAIRPICO/bioimageflow
Project-URL: Documentation, https://bioimageflow.readthedocs.io/latest/
Project-URL: Repository, https://github.com/Inria-SAIRPICO/bioimageflow
Project-URL: Issues, https://github.com/Inria-SAIRPICO/bioimageflow/issues
Author: BioImageFlow Contributors
License-Expression: BSD-4-Clause
License-File: LICENSE
Keywords: bioimage-analysis,bioimageflow,microscopy,workflow
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.10
Requires-Dist: bioimageflow-core<0.4,>=0.3.0
Requires-Dist: bioimageflow<1,>=0.1.6
Requires-Dist: imageio>=2.31.0
Requires-Dist: numpy>=1.23.5
Requires-Dist: pandas>=2.0.0
Requires-Dist: scikit-image>=0.21.0
Requires-Dist: scipy>=1.10.0
Description-Content-Type: text/markdown

# bioimageflow-tracking-tools

Tools for label-stack object extraction, deterministic centroid linking, track rendering, and migration metrics.

## Tools

- `LabelsToObjects`: converts 2D or TYX label images into source-keyed object centroid and area tables.
- `NearestNeighborLink`: links adjacent-frame objects with global one-to-one distance assignment, independently per source label stack when the source key is present.
- `TrackMetrics`: computes explicit duration, path length, net displacement, speed, and area summaries.
- `FilterObjects`: filters object tables by area, frame, intensity, and position.
- `TracksToLabels`: renders track IDs back into label stacks.
- `TrackTableValidate`: validates required columns, frame order, and duplicate track frames.
- `TrackQualityMetrics`: computes gap counts, duplicate assignment conflicts, and short-track fraction.

The package intentionally does not expose Ultrack or btrack table adapters: those libraries require richer native tracking workflows than a centroid-table compatibility shim can represent truthfully.
