calc_selection_weights: Calculate Selection Weights

In ARUtools: Management and Processing of Autonomous Recording Unit (ARU) Data

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
)

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).

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

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)

ARUtools documentation built on Oct. 9, 2024, 1:07 a.m.