Skip to contents

Derive trial-level track positions in polar coordinates.

Source: R/circular_trials.R
get_tracked_object_pos.Rd

Using the trial limits returned by [get_trial_limits()], this helper extracts the corresponding rows from a track data frame or `TrajSet`, centres and scales the coordinates, and computes angles in both absolute and reference-relative frames. The function optionally controls how inner/outer radius crossings are selected.

Usage

get_tracked_object_pos(
  trial_limits,
  animal_track,
  circ0 = 0.1,
  circ1 = 0.2,
  radius_criterion = c("first_past", "closest")
)

Arguments

trial_limits

Data frame produced by [get_trial_limits()].

animal_track

Data frame or `TrajSet` of Cartesian coordinates for the entire video.

circ0

Inner radius threshold (default `0.1`).

circ1

Outer radius threshold (default `0.2`).

radius_criterion

Strategy for choosing the radius landmarks. `"first_past"` selects the first point beyond each threshold, while `"closest"` chooses the closest sample to the specified radius.

Value

A `TrajSet` containing all valid trial observations. The corresponding trial limits (including `valid_track` flags) are stored in `meta$trial_limits`.