Quickstart (MAT)

Launch

hydra

The main window opens maximized and exposes the tabbed workflow.

Minimal End-to-End Run

1. Setup tab:
2. Select input video.
3. Select CSV output path.
4. Optionally choose video output path.
5. Detection tab:
6. Choose background_subtraction for moving animals on stable backgrounds.
7. Choose yolo_obb for harder scenes or stationary animals.
8. Tracking tab:
9. Set MAX_TARGETS.
10. Keep defaults first for Kalman and assignment.
11. Processing tab:
12. Keep post-processing enabled.
13. Choose interpolation only if short gaps are expected.
14. Click Start Tracking.

Important First-Run Checks

• ROI is set correctly.
• reference_body_size is realistic.
• Detection preview shows one detection per target on representative frames.

Outputs

• Main CSV trajectory file
• Optional forward/backward/intermediate outputs
• Optional rendered output video
• Optional detection cache (.npz) when caching is enabled

Need to Correct Missed Detections?

For frame-by-frame correction and adding missed animals with X-AnyLabeling (SAM2, SAM3, manual segmentation, or OBB), see Integrations.