Metadata-Version: 2.4
Name: bioimageflow-tracking-tools
Version: 0.1.7
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.3,>=0.1.6
Requires-Dist: bioimageflow<0.4,>=0.1.6
Requires-Dist: imageio>=2.31.0
Requires-Dist: numpy>=1.23.5
Requires-Dist: pandas>=2.0.0
Description-Content-Type: text/markdown

# bioimageflow-tracking-tools

Tools for label-stack object extraction, Ultrack and btrack adapters, and migration metrics.

## Tools

- `LabelsToObjects`: converts 2D or TYX label images into object centroid and area tables.
- `UltrackLink`: links object tables with Ultrack.
- `BTrackLink`: links object tables with btrack.
- `TrackMetrics`: computes track length, 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.
- `TrackSummary`: reports duration, displacement, speed, and frame bounds per track.
- `TrackQualityMetrics`: computes gap counts, split/merge flags, and short-track fraction.

Use the live-cell migration tracking workflow in the main workflow catalog for a complete Ultrack and btrack comparison.
