Get ground-truth transitions for tuning and validation

Functions to get ground truth routes and transitions for model tuning and validation by combining tracking, Motus, and banding sources, then converting to BirdFlowR::BirdFlowIntervals() objects (full intervals and 1-week intervals).

Usage

get_transitions(loader, max_n_intervals = 10000)

Arguments

loader

A TransitionsLoader() object.

max_n_intervals

the maximum intervals to sample.

Value

A list with:

combined_routes_data

data.frame of stacked banding, Motus, and tracking rows (NA-dropped).

interval_obj

BirdFlowR::BirdFlowIntervals() with 1–180 day / 0–8000 km constraints, filtered to migration seasons.

interval_one_week_obj

BirdFlowR::BirdFlowIntervals() with exactly 1-day steps (weekly objects), filtered to migration seasons.

Details

Side effects:

• Resolves/prints a source string reflecting which datasets were found.

• Errors if no transitions are available or if fewer than \(10/0.7\) intervals remain for tuning.

See also

TransitionsLoader(), split_data.TransitionsLoader(), train_test_split(), BirdFlowR::Routes(), BirdFlowR::as_BirdFlowRoutes(), BirdFlowR::as_BirdFlowIntervals()

Examples

if (FALSE) { # \dontrun{
tl <- TransitionsLoader(trainer)
gt <- get_transitions(tl)
str(gt$interval_obj$data)
} # }