ARUtools (version 0.7.2)

calc_selection_weights: Calculate Selection Weights

Description

Calculate selection weights for a series of recordings based on the selection parameters defined by sim_selection_weights().

Usage

calc_selection_weights(
  meta_sun,
  params,
  col_site_id = site_id,
  col_min = t2sr,
  col_day = date
)

Value

Returns data with appended selection weights columns:

• psel_by - The minutes column used

• psel_min - Probability of selection by time of day (min column)

• psel_doy - Probability of selection by day of year

• psel - Probability of selection overall

• psel_scaled - Probability of selection scaled overall

• psel_std - Probability of selection standardized within a site

• psel_normalized - Probability of selection normalized within a site

Arguments

meta_sun

(Spatial) Data frame. Recording meta data with time to sunrise/sunset. Output of calc_sun(). Must have at least col_min, col_day, and col_site_id.

params

Named list. Parameters created by sim_selection_weights(), containing min_range, min_mean, min_sd, day_range, day_mean, day_sd, offset, return_log, selection_fun.

col_site_id

Column. Unquoted column containing site strata IDs (defaults to site_id).

col_min

Column. Unquoted column containing minutes to sunrise (t2sr) or sunset (t2ss) output from calc_sun() (defaults to t2sr).

col_day

Column. Unquoted column containing dates or day-of-year (doy) to use (defaults to date).

Examples

s <- clean_site_index(example_sites_clean,
  name_date_time = c("date_time_start", "date_time_end")
)
m <- clean_metadata(project_files = example_files) |>
  add_sites(s) |>
  calc_sun()

params <- sim_selection_weights()
calc_selection_weights(m, params = params)