Skip to contents

Summarise per-trial metadata for a single video.

Source: R/circular_trials.R
get_trial_limits.Rd

Uses paired landmark coordinates to determine the temporal bounds of each trial, the arena origin, and the reference heading. Additional metadata from `file_tbl` is merged into the result. Accepts landmark and track data either as data frames or as `TrajSet` objects.

Usage

get_trial_limits(
  landmarks,
  animal_track,
  file_tbl,
  vid_num,
  midpoint = "midpoint"
)

Arguments

landmarks

Data frame or `TrajSet` (two rows per trial) containing frame numbers and landmark coordinates.

animal_track

Data frame or `TrajSet` of Cartesian coordinates for all frames in the video.

file_tbl

Tibble returned by [import_tracks()] (optionally enriched by [load_tracks()] or [load_tracks2()]).

vid_num

Index of the current video within `file_tbl`.

midpoint

Character flag indicating whether reference angles should be shifted to the midpoint (`"midpoint"`, default) or left as-is.

Value

A tibble with one row per trial containing trial limits and reference metadata.