Read design recaps aggregated by analysis unit

Returns a summary of survey designs aggregated to the analysis unit (DAU) level. One row per DAU x survey type x bio year. Backed by a materialized view, so lightweight even for large datasets.

Usage

sight_read_design_recaps(
  species = NULL,
  survey_type = NULL,
  analysis_unit = NULL,
  bio_year = NULL,
  pages = list(omit = 1),
  dry_run = FALSE,
  ...
)

sight_read_design_recaps_id(
  species_id = NULL,
  survey_type_id = NULL,
  analysis_unit_id = NULL,
  bio_year = NULL,
  pages = list(omit = 1),
  dry_run = FALSE,
  ...
)

Arguments

species

the common name of the species, for example "Mule Deer"

survey_type

the name of the survey type, for example "Sightability"

analysis_unit

the name of the analysis unit

bio_year

the biological year

pages

a named list with pagination options, see sight_read_entries() for details

dry_run

If TRUE, print the HTTP request without sending it and return the request object invisibly. Useful for debugging.

...

Additional arguments passed to the underlying spdgt.auth function (e.g., verbosity, timeout).

species_id

the ID of the species

survey_type_id

the ID of the survey type

analysis_unit_id

the ID of the analysis unit (DAU)

Value

A tibble with columns: project_id, project, bio_year, survey_type_id, survey_type, species_id, species, analysis_unit_id, analysis_unit, all_subunits, stratified_subunits, selected_subunits, surveyed_subunits, management_unit_recaps.

See also

sight_read_surveys() for observation-level summaries

Examples

if (FALSE) { # \dontrun{
# Design recaps for all Mule Deer DAUs
sight_read_design_recaps(species = "Mule Deer")

# Filter by year
sight_read_design_recaps(species = "Mule Deer", bio_year = 2025)
} # }