Expand description
Crocker–Grier style 2D particle linking across frames (trackpy / IDL lineage).
Links detections (x, y, frame) with:
- max distance — Euclidean gate between consecutive frames
- assignment — greedy nearest-neighbour, or LAP-lite (cost-sorted edges)
- memory / miss gap — a track may skip up to
memoryframes without a hit - fixed max tracks — overflow births rejected deterministically (
track_id = 0)
Pure Rust; fixed slot table + stack scratch on the link path.
Reference: Crocker & Grier, J. Colloid Interface Sci. (1996); trackpy link.
Structs§
- Crocker
Grier Linker - Bounded Crocker–Grier particle tracker.
- Crocker
Grier Params - Parameters for Crocker–Grier linking.
- Detection2
- Compact detection for the free-function linker (x, y, frame only).
- Linked
Particle - One linked particle observation (detection + assigned track id).
- Track
Link - Per-detection link result for
crocker_grier_link.
Constants§
- MAX_
FRAME_ DETS - Max detections considered per frame (association scratch).
- MAX_
PARTICLE_ TRACKS - Maximum simultaneous active tracks.
- NO_
TRACK_ ID - Sentinel: detection not assigned a track.
Functions§
- crocker_
grier_ link - Free-function Crocker–Grier link over compact
Detection2rows. - link_
particles - One-shot convenience: link a full detection list with fresh linker state.