Changelog • aniread

aniread 0.4.1

read_octron() gains a properties argument for picking which region-property columns to read ("all" by default; pass a character vector for a subset or NULL to skip them). area is auto-included when method = "weighted".
read_octron() normalises hyphens to underscores in column names (moments_hu-0 → moments_hu_0).

read_octron() is now substantially faster on large multi-segment files, especially when only a few properties are requested.

read_octron(method = "weighted") no longer silently recycles v * a when a row’s value and area columns have different segment counts; it falls back to the arithmetic mean for those rows and emits a single warning naming the affected frame_idx values.

Readers whose source data uses image (top-left) origin now reflect y so the returned aniframe is in the conventional bottom_left origin. This fixes plots being upside-down without manual reorientation. Affects read_animalta(), read_bonsai(), read_deeplabcut(), read_fasttrack(), read_idtracker(), read_lightningpose(), read_movement(), read_octron(), read_sleap(), read_trackmate(), and read_trex() (#61).
aniframe (>= 0.5.0) is now required, since the reflection uses the new set_origin() / set_y_height() API.

All affected readers gain an optional video_height argument for supplying the source frame height when the format does not record it (DeepLabCut, LightningPose, SLEAP, AnimalTA, Bonsai, FastTrack, TRex, idtracker.ai CSV, movement netCDF). When omitted, the reader falls back to source-extracted values where available, and finally to max(y).
read_idtracker() now reads /height from the trajectories h5 file by default.
read_trackmate() now reads the frame height from Settings/ImageData/@height in the XML by default.
read_octron() continues to read video_height: from the CSV header, but now also accepts a video_height override and stores the value in the aniframe metadata.
read_octron() gains a method argument to handle frames where Octron emitted multiple mask segments for the same track (#67). One of "weighted" (default; area-weighted mean of position and shape props, sum of areas), "largest" (single largest segment per row), or "segments" (one row per segment, with a new segment identity variable).

read_idtracker() now accepts both the legacy seconds and the newer time leading column in idtracker.ai CSV exports (#60).

Adds read_aniframe that allows you to read your saved aniframes (in .parquet format) back into R!
Adds read_movement for importing data from the awesome movement Python package.
Adds read_c3d for importing C3D motion capture data.
Adds read_fasttrack for importing FastTrack data.
Adds support for HDF5 DeepLabCut files in read_deeplabcut.

Adapt to the tidy movement data ethos implemented in aniframe 0.4.0.
Adds read_trackmate for TrackMate XML files. Thanks to @quantixed for writing the reader function in TrackMateR, which has been adapted here.
Adds read_octron for Octron CSV files.