marEx.TrackingError

exception marEx.TrackingError(message, details=None, suggestions=None, error_code='TRACKING_ERROR', context=None)[source]

Bases: MarExError

Raise exception for object tracking and identification issues.

This exception covers problems specific to the tracking module including binary object identification, temporal linking, and merge/split handling.

Common scenarios:

  • Invalid binary input data

  • Tracking parameter conflicts

  • Temporal continuity issues

  • Memory overflow during tracking

  • Checkpoint/resume failures

Examples

>>> raise TrackingError(
...     "Tracking failed due to excessive memory usage",
...     details="Event fragmentation created >100,000 objects per timestep",
...     suggestions=["Increase area_filter_quartile to remove small events",
                      "Apply stronger spatial smoothing before tracking",
                      "Consider processing shorter time periods"],
...     context={"objects_per_timestep": 150000, "memory_limit_gb": 32}
... )

Initialise the Error.

Parameters:
__init__(message, details=None, suggestions=None, error_code='TRACKING_ERROR', context=None)[source]

Initialise the Error.

Parameters: