LapTrack

Features

Provides a robust particle tracking algorithm using the Linear Assignment Problem, with various cost functions for linking.

See the publication and associated repository for the algorithm and parameter optimization by Ray-Tune.

Requirements

Python >= 3.10 is supported. The software is tested against Python 3.10-3.14 in Ubuntu, and 3.14 in MacOS and Windows environments, but the other combinations should also be fine. Please file an issue if you encounter any problem.

Installation

You can install LapTrack via pip from PyPI:

$ pip install laptrack

In Google Colaboratory, try

$ pip install --upgrade laptrack spacy flask matplotlib

to update the pre-installed packages.

Usage

Please see the Usage for details. The example notebooks are provided in docs/examples.

notebook name	short description	Google Colaboratory
api_example.ipynb	Introducing the package API by a simple example.
bright_spots.ipynb	Application example: detecting bright spots by scikit-image blob_log and tracking them.
cell_segmentation.ipynb	Application example: tracking centroids of the segmented C2C12 cells undergoing divisions.
napari_interactive_fix.ipynb	Illustrates the usage of the ground-truth-preserved tracking with napari.
overlap_tracking.ipynb	Illustrates the usage of the custom metric to use segmentation overlaps for tracking.

The API reference covers the main classes and functions provided by LapTrack.

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide.

License

Distributed under the terms of the The 3-Clause BSD License, LapTrack is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This program implements a modified version of the algorithm in the K. Jaqaman et al. (2008).
Inspired by TrackMate a lot. See documentation for its detailed algorithm, the 2016 paper, and the 2021 paper.
The data in docs/examples/napari_interactive_fix_data are generated by cropping images in 10.5281/zenodo.6087728, which is distributed with Creative Commons Attribution 4.0 International.
The data in docs/examples/cell_segmentation_data are generated by cropping and resizing images in https://osf.io/ysaq2/, which is distributed with Creative Commons Attribution 4.0 International. See 10.1038/sdata.2018.237 for details.
The data in docs/examples/overlap_tracking_data is generated by cropping segmentation.npy in https://github.com/NoneqPhysLivingMatterLab/cell_interaction_gnn, which is distributed with Apache License 2.0. See the original paper for details.
The data in docs/examples/3D_tracking_data is generated by resizing iamges in https://bbbc.broadinstitute.org/BBBC050 , which is distributed with Creative Commons Attribution 3.0 Unported License. See 10.1038/s41540-020-00152-8 for details.
This project was generated from @cjolowicz’s Hypermodern Python Cookiecutter template.

Citation

If you use this program for your research, please cite it and help us build more.

@article{fukai_2022,
  title = {{{LapTrack}}: Linear Assignment Particle Tracking with Tunable Metrics},
  shorttitle = {{{LapTrack}}},
  author = {Fukai, Yohsuke T and Kawaguchi, Kyogo},
  year = {2022},
  month = dec,
  journal = {Bioinformatics},
  pages = {btac799},
  issn = {1367-4803},
  doi = {10.1093/bioinformatics/btac799},
}

@misc{laptrack,
   author = {Yohsuke T. Fukai},
   title = {laptrack},
   year  = {2021},
   url   = {https://doi.org/10.5281/zenodo.5519537},
}

Metadata

Release files for laptrack 0.17.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for laptrack 0.17.1
File	Size	Uploaded
laptrack-0.17.1.tar.gz	24.2 MB	Feb 10, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for laptrack 0.17.1
File	Interpreter	ABI	Platform	Reset
laptrack-0.17.1-py3-none-any.whl 30.7 kB Feb 10, 2026	Python 3	none	any	Details

Total release size: 24.2 MB

Release files / laptrack-0.17.1.tar.gz

Download URL	laptrack-0.17.1.tar.gz
Size	24.2 MB
Tags	Source
SHA-256 checksum How to use checksums	`883330e5cda46343fc6581434161950669cda0f2fce33aac06440ebd2444aa00`
BLAKE2b-256 checksum How to use checksums	`0d4f8a7d969e8d7bf54231af71e230eff17d15822119bf34bb7d4e0c41fb8785`
Upload date	Feb 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.8.17`

Release files / laptrack-0.17.1-py3-none-any.whl

Download URL	laptrack-0.17.1-py3-none-any.whl
Size	30.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`dbba06163dc7fa591e4ac05781bf4e3ef95513b49954f03a45a2e225a4ecd5e1`
BLAKE2b-256 checksum How to use checksums	`f9c13376610c901305bde4b45f4ff93d84a9850162c986e22859b798b14072e6`
Upload date	Feb 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.8.17`