Load trajectories listed in a file table into a TrajSet — TrajSet_load

This high-level helper combines the file discovery tibble returned by [import_tracks()] with optional metadata from an experiment manifest, reads each track file using [TrajSet_read()], and merges the results into a single `TrajSet`.

Usage

TrajSet_load_manifest(
  file_tbl,
  track_dir,
  manifest = NULL,
  manifest_cols = NULL,
  mapping = NULL,
  angle_unit = c("radians", "degrees", "auto"),
  time_type = c("auto", "posix", "seconds", "frames"),
  tz = "UTC",
  fps = NULL,
  normalize_xy = TRUE,
  dialect = NULL,
  keep = NULL,
  drop = NULL,
  ...
)

Arguments

file_tbl: Tibble returned by [import_tracks()], containing at least the columns `basename` and `track`.
track_dir: Directory containing the track files on disk.
manifest: Optional data frame with a `file` column that matches `file_tbl$basename`.
manifest_cols: Optional named character vector (or list) mapping new column names in `file_tbl` to column names present in `manifest`. When `NULL`, all columns aside from `file` are carried over with the same names.
mapping: Optional explicit column mapping passed to [TrajSet_read()].
angle_unit, time_type, tz, fps: Passed to [TrajSet_read()].
normalize_xy: Logical; normalise x/y to unit circle. Default TRUE.
dialect: Optional dialect name; passed to [TrajSet_read()].
keep, drop: Column selection vectors passed to [TrajSet_read()].
...: Additional arguments forwarded to [TrajSet_read()].

Value

A `TrajSet` with metadata columns replicated for each observation.