How trackmate-sc/trackmate works
TrackMate is a Fiji plugin for single-particle tracking in life-science images. A user works through a wizard to configure segmentation and particle linking, review or edit results, analyze tracks, and export them. The repository separates the central model from detection, tracking, feature analysis, visualization, and persistence; extension providers and post-processing actions support additional algorithms and workflows. The README documents the overall user flow and capabilities; source excerpts are partial, so individual implementation-level calls are not inferred where they are not shown.
Main entry points: Model.java Tracking model · TrackMate.java Workflow engine · WizardController.java Tracking wizard · action Post-processing actions
Components 21
User workflow
- Tracking wizard
src/main/java/fiji/plugin/trackmate/gui/wizard/WizardController.java - Image settings
src/main/java/fiji/plugin/trackmate/Settings.java - Workflow engine
src/main/java/fiji/plugin/trackmate/TrackMate.java
Tracking engine
- Spot detection
src/main/java/fiji/plugin/trackmate/detection - Spot records
src/main/java/fiji/plugin/trackmate/Spot.java - Spot collection
src/main/java/fiji/plugin/trackmate/SpotCollection.java - Particle linking
src/main/java/fiji/plugin/trackmate/tracking - Tracking model
src/main/java/fiji/plugin/trackmate/Model.java - Track graph
src/main/java/fiji/plugin/trackmate/TrackModel.java
Analysis and views
- Feature analysis
src/main/java/fiji/plugin/trackmate/features - Spot and track filters
src/main/java/fiji/plugin/trackmate/features/FeatureFilter.java - Feature plots
src/main/java/fiji/plugin/trackmate/features - Tracking views
src/main/java/fiji/plugin/trackmate/visualization - View settings
src/main/java/fiji/plugin/trackmate/gui/displaysettings/DisplaySettings.java
Extensions and editing
- Label editing
src/main/java/fiji/plugin/trackmate/gui/editor/labkit - Algorithm providers
src/main/java/fiji/plugin/trackmate/providers - Post-processing actions
src/main/java/fiji/plugin/trackmate/action
Persistence and export
- TrackMate XML
src/main/java/fiji/plugin/trackmate/io/TmXmlWriter.java - CSV export
src/main/java/fiji/plugin/trackmate/io/CSVExporter.java
Other components
- Image analyst
- Analysis software
Connections 25
- Image analyst → Tracking wizard: configures workflow
- Tracking wizard → Image settings: sets parameters
- Tracking wizard → Workflow engine: runs tracking
- Workflow engine → Spot detection: segments spots
src/main/java/fiji/plugin/trackmate/TrackMate.java - Workflow engine → Particle linking: links particles
src/main/java/fiji/plugin/trackmate/TrackMate.java - Spot detection → Spot collection: produces detections
- Spot collection → Spot records: holds spots
src/main/java/fiji/plugin/trackmate/SpotCollection.java - Particle linking → Track graph: reconstructs tracks
- Tracking model → Spot collection: manages spots
src/main/java/fiji/plugin/trackmate/Model.java - Tracking model → Track graph: manages tracks
src/main/java/fiji/plugin/trackmate/Model.java - Workflow engine → Tracking model: stores results
src/main/java/fiji/plugin/trackmate/TrackMate.java - Tracking model → Feature analysis: supports analysis
src/main/java/fiji/plugin/trackmate/Model.java - Feature analysis → Feature plots: feeds plots
- Tracking model → Spot and track filters: filters results
src/main/java/fiji/plugin/trackmate/Model.java - Tracking model → Tracking views: renders results
src/main/java/fiji/plugin/trackmate/visualization/trackscheme/utils/SearchBar.java - Image analyst → Tracking views: reviews results
- View settings → Tracking views: configures display
- Image analyst → Label editing: edits labels
- Algorithm providers → Spot detection: supplies algorithms
- Algorithm providers → Particle linking: supplies algorithms
- Image analyst → Post-processing actions: runs post-processing
- Post-processing actions → TrackMate XML: exports results
- Post-processing actions → CSV export: exports tables
- TrackMate XML → Analysis software: shares data
- CSV export → Analysis software: shares data