Skip to content

Repository navigation

AMADEUS v1.2.1

Choose a tag to compare

View all tags
@jpmyrmecol jpmyrmecol released this 14 Oct 16:00
· 187 commits to main since this release
v1.2.1
7c74a21
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

AMADEUS v1.2.1

This release substantially improves temporal merge detection, simplifies the Segmentation GUI, and introduces persistent search results for a more efficient workflow.

Temporal Merge Detection (Beta)

  • Improved detection of merged animals using bidirectional temporal evidence, including backward inference from later splitting events.
  • Improved tracking of animal counts through complex merging and splitting events, including cases where three animals separate into a pair and a single animal.
  • Removed the temporal search horizon, allowing merge evidence to persist without an arbitrary time limit.
  • Fixed the minimum confirmation length to 2 frames.
  • Added configurable Containment, Share rounding, and One-sided mass ratio parameters.
  • Improved detection of merging animals that are close together, without requiring a minimum separation based on body length.
  • Improved robustness to temporary contour deformation and ambiguous interactions.

Segmentation Workflow and Visualization

  • Moved Exclude temporal merges before Outlier Extraction.
  • Unified all temporal merge candidates under violet highlighting, regardless of evidence category. Additional statistical outliers are highlighted in orange.
  • Improved IQR analysis by excluding confirmed temporal merges from the reference population.
  • Added estimated animal counts to the hover information, such as crossing(2) and crossing(3).
  • Added previous/next outlier-frame navigation buttons to the Analysis section.
  • Reduced the IQR boxplot height and added double-click support to reset individual threshold handles to 1.5×IQR.
  • The Temporal Merge Detection section is hidden by default and appears when optional settings are shown or the feature is enabled.

Persistent Temporal Search Results

  • Temporal merge search results are now automatically saved to a compressed .npz cache alongside the Segmentation configuration.
  • Saved results are automatically restored when reopening a compatible configuration, avoiding unnecessary rescanning.
  • Cached results are validated against the source video, segmentation settings, detection parameters, and relevant code.
  • Invalid or incompatible caches are safely ignored.

Other Improvements

  • Added a confirmation popup when Save config completes successfully.
  • Fixed duplicate AMADEUS version information in startup output across platforms.
  • Improved memory efficiency when evaluating long temporal histories.

Notes

  • Temporal Merge Detection remains experimental (Beta) and disabled by default.
  • Violet highlighting includes uncertain candidates; automatic exclusion still depends on evidence strength and reliability checks.
  • Re-running Search is required when relevant settings or source data change.

Full changelog: v1.2.0...main

Assets 2
Loading