Skip to content

AMADEUS v1.2.8

Latest

Choose a tag to compare

@jpmyrmecol jpmyrmecol released this 29 Oct 05:23
65f12dc

AMADEUS v1.2.8

This release improves the Refinement workflow with continuous editing during video playback, support for reloading corrected CSV files, and more efficient candidate navigation. It also introduces selectable video quality for Cropping & Trimming and optimizes video encoding settings across AMADEUS.

Refinement Improvements

Continuous Editing During Playback

  • Arrow positions and individual endpoints can now be adjusted continuously while a video is playing.
  • Corrections are applied to every traversed frame, including frames skipped during playback rendering or delayed decoding.
  • Supports both forward and reverse playback.
  • Editing stops at the correct frame when the mouse is released or playback stops, even when asynchronous decoding is still in progress.
  • When adjusting only one endpoint, the opposite endpoint retains its original position in each frame.
  • Manual frame navigation continues to support individual frame corrections.

Loading Previously Refined CSV Files

  • Added a CSV path selector and Load CSV button next to the Dataset selector.
  • Reduced the width of the Dataset selector to accommodate the new controls.
  • Added per-dataset CSV path history, automatically recording saved and loaded CSV files.
  • Previously corrected CSV files can now be reopened for further Refinement.
  • When loading a corrected CSV, AMADEUS compares the original and loaded trajectories to identify frame-specific ID switches.
  • Refinement candidate IDs are automatically remapped to match the loaded CSV.
  • Detected ID switch frames are reported. Ambiguous ID correspondences remain explicitly unresolved rather than being assigned arbitrarily.
  • Added validation of frame counts and ID counts to prevent loading incompatible tracking data.
  • Improved protection of original tracking data when saving corrected CSV files.

Improved Refinement Candidate Navigation

  • Consecutive candidate frames with the same individual ID and classification are now grouped into a single entry.
  • Only the first frame of each consecutive candidate group is displayed.
  • Candidate grouping accounts for ID switches and classification changes.
  • Updated candidate navigation, classification filters, and edit status indicators to work consistently with grouped candidates.
  • Original frame-level candidate information remains available internally.

Video Export Improvements

Selectable Quality in Cropping & Trimming

  • Added a Video quality selector with two options:
    • Standard: Smaller, more efficient video output for general use.
    • High: Higher visual fidelity for preparing videos used as tracking inputs.
  • High is the default for Cropping & Trimming.
  • Existing Cropping & Trimming configurations without a quality setting retain High quality.
  • CPU H.264 encoding uses CRF 23 for Standard and CRF 18 for High.
  • Hardware encoders use corresponding encoder-specific quality settings.
  • Removed source bitrate ceilings to avoid unnecessarily restricting output quality.

Standard Quality for Other Video Exports

  • Tracking visualization videos now use Standard quality by default.
  • Applied Standard quality consistently to Create Video exports, including tracking without direction estimation.
  • Refinement video exports also use Standard quality.
  • Separate JPEG and PNG image export settings remain unchanged.
  • Video encoding is performed directly from rendered frames.

macOS Encoding Improvements

  • Changed the default H.264 encoder on macOS to CPU-based libx264.
  • Apple VideoToolbox hardware encoding remains available as an explicit option.
  • The Cropping & Trimming interface identifies this option as VideoToolbox (faster).
  • Windows and Linux continue to prefer validated hardware encoding when acceleration is set to automatic.
  • Hardware encoding failures retain CPU fallback behavior.

Compatibility and Notes

  • Cropping & Trimming uses High quality by default to prioritize input video fidelity.
  • Other video exports use Standard quality because they are primarily intended for visualization and verification.
  • Output file sizes depend on the encoder, resolution, frame rate, and visual content. Standard quality does not guarantee a smaller file than the original video.
  • Existing Cropping & Trimming configurations remain compatible.