Add Filter trajectories

[Edu92337]

Description

What is this PR

• Addition of a new feature

Why is this PR needed?

Tracking data often contains spurious short trajectories that are likely tracking errors. Currently, users need to manually write complex xarray selection code to filter these out. This PR adds a convenient utility function to streamline this common preprocessing task.

What does this PR do?

Adds filter_short_trajectories() function to movement.filtering module that:

• Filters out individuals with fewer than a specified number of valid frames
• Works at the Dataset level (filtering across all data variables)
• Supports both poses and bounding boxes datasets
• Includes optional print_report parameter to show which individuals were filtered
• Follows existing filtering function patterns (consistent error handling with logger.error)

References

Closes #791

How has this PR been tested?

• Added comprehensive unit tests in tests/test_unit/test_filtering.py covering:
  • Basic filtering for both poses and bboxes datasets
  • Edge cases (no individuals removed, all individuals removed, exact threshold)
  • Input validation (negative, zero, float, invalid types)
  • Missing individuals dimension
  • Attribute and coordinate preservation
  • Print report functionality
• All existing tests pass
• Tested manually with sample datasets to verify expected behavior

Is this a breaking change?

No. This is a new function with no changes to existing functionality.

Does this PR require an update to the documentation?

The function includes a comprehensive docstring with examples. The function will automatically appear in the API reference documentation when built. No additional documentation updates needed at this time, though a usage example could be added to the user guide in a future PR if desired.

Checklist:

• The code has been tested locally
• Tests have been added to cover all new functionality
• The documentation has been updated to reflect any changes
• The code has been formatted with pre-commit

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (447492e) to head (7d5710f).

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #796   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           36        36           
  Lines         2205      2230   +25     
=========================================
+ Hits          2205      2230   +25     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud