Abundance of species given sampling effort

Sum of number across visits, with mean individuals per visit. Empty visits contribute zero. Missing number is treated as 0 for the sum.

Usage

obs_abundance(
  x,
  by = "species",
  period = "month",
  location = NULL,
  user = NULL,
  species = NULL,
  group = NULL,
  protocol = NULL,
  date = NULL,
  date_start = NULL,
  date_end = NULL
)

Arguments

x: Path to a project SQLite export, a project obs_df, or a visit tibble from obs_visits().
by: Grouping besides species: "species" (default, overall), "location", "period", or a combination.
period: When by includes "period": "month" (default), "year", "week" (ISO) or "day".
location: Location id or name (partial match). Restricts effort.
user: Observer id or name. Restricts effort.
species: Scientific or common name (partial match). Restricts the reported taxa, not the visits.
group: Species group name. Restricts the reported taxa.
protocol: Protocol id or name. Restricts effort.
date: Length-2 vector c(start, end) as "YYYY-MM-DD", or a single date.
date_start, date_end: Bounds on visit.start_date.

Value

A tibble with n_visits, n_records, n_individuals and mean_per_visit.

Details

location, user, protocol and dates restrict the visit set (the effort). species and group restrict which taxa are reported; they do not drop visits without those taxa.

When visit.counted is in the export, visits whose completeness does not allow an abundance analysis (counted other than i or h) emit a warning. They are still included. If the column is absent, nothing is warned.

Examples

if (FALSE) { # \dontrun{
obs_abundance("project-export.sqlite")
obs_abundance(db, by = "location", protocol = "Road survey")
} # }