Add baseline temperatures of species- or study-area polygons for each range shift

Usage

add_baselines(
  data,
  type = "SA",
  stat = c("mean"),
  exp = c("temp"),
  res = c(LAT = "25km", ELE = "1km")
)

Arguments

data: input data from get_shifts()
type: Choice of baseline temperatures from study area (SA) or species area (SP) polygons.
stat: Statistic of the given variable. Choices are min, 1Q, median, mean, 3Q, max.
exp: Exposure variable; Choices are "temp" (temperature") or "precip" (precipitation), or both.
res: Calculation resolution. Baseline temperatures in each species/study area were calculated with environmental raster layers at up to four resolutions: 1km, 25km, 50km, 110km, resulting in slightly different values. Choose a specific res ("1km","25km","50km","110km"), or use "best" to ensure each shift has a matching temperature (see vignette)

Value

Shifts database supplemented with selected temperature and/or precipitation baseline values within the study area or species-specific study area.

Examples

get_shifts() |> add_baselines()
#> # A tibble: 31,759 × 15
#>    id         article_id poly_id method_id eco   type  param sp_name_publication
#>    <chr>      <chr>      <chr>   <chr>     <chr> <chr> <chr> <chr>              
#>  1 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Ambloplites_rupest…
#>  2 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Ameiurus_nebulosus 
#>  3 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Chrosomus_eos      
#>  4 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Lepomis_gibbosus   
#>  5 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Lepomis_macrochirus
#>  6 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Luxilus_cornutus   
#>  7 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Micropterus_dolomi…
#>  8 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Micropterus_salmoi…
#>  9 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Notemigonus_crysol…
#> 10 A002_P1_L… A002       P1      M01       Ter   LAT   LE    Notropis_atherinoi…
#> # ℹ 31,749 more rows
#> # ℹ 7 more variables: sp_name_checked <chr>, subsp_or_pop <chr>,
#> #   calc_rate <dbl>, calc_unit <chr>, direction <chr>,
#> #   baseline_mean_temp <dbl>, baseline_res <chr>
get_shifts(eco = "Mar") |> add_baselines(res = "25km")
#> Error in get_shifts(eco = "Mar"): unused argument (eco = "Mar")