Query by year/location and return one joined data frame — timefish_query_local

This helper is a high-level workflow for users who first select years and localities, then want the corresponding census records enriched with taxonomic fields in a single data frame.

Usage

timefish_query_local_join(
  year = NULL,
  country = NULL,
  state = NULL,
  location = NULL,
  site = NULL,
  location_filters = list(),
  census_filters = list(),
  taxonomic_filters = list(),
  ignore_case = TRUE
)

Arguments

year: Optional year filter. Accepts a single year, a vector of years, or timefish_between().
country: Optional country filter for the location table.
state: Optional state filter for the location table.
location: Optional location filter for the location table.
site: Optional site filter for the location table.
location_filters: Optional additional named filters for the location table.
census_filters: Optional additional named filters for the census table.
taxonomic_filters: Optional additional named filters for the taxonomic table.
ignore_case: Treat character filters as case-insensitive matches.

Value

A joined data frame containing filtered census + location + taxonomic information.

Examples

joined_2020 <- timefish_query_local_join(
  year = 2020,
  country = "Brazil",
  state = c("Santa Catarina", "Sao Paulo")
)