Skip to contents

Convenience siblings of the dataset-scoped clb_*() functions that always operate on the latest extended Catalogue of Life release. They take the same arguments as their clb_*() counterparts but without the dataset parameter; the release is resolved once to its integer key via col_key() and reused for the rest of the session (see col_refresh() to re-pin).

Usage

col_match(
  name,
  authorship = NULL,
  rank = NULL,
  code = NULL,
  server = NULL,
  .raw = FALSE
)

col_match_verbose(
  name,
  authorship = NULL,
  rank = NULL,
  code = NULL,
  server = NULL,
  .raw = FALSE
)

col_match_checklist(
  data,
  name = "name",
  authorship = "authorship",
  rank = "rank",
  code = "code",
  server = NULL,
  max_active = 5L
)

col_dataset(.raw = FALSE)

col_dataset_metrics(.raw = FALSE)

col_usage(id, .raw = FALSE)

col_usage_info(id, .raw = FALSE)

col_usage_search(
  q = NULL,
  rank = NULL,
  status = NULL,
  ...,
  limit = 50L,
  max = limit
)

col_search(q = NULL, rank = NULL, status = NULL, ..., limit = 50L, max = limit)

col_suggest(q, ..., .raw = FALSE)

col_classification(id, .raw = FALSE)

col_synonyms(id, .raw = FALSE)

col_vernacular(
  id = NULL,
  q = NULL,
  lang = NULL,
  ...,
  limit = 50L,
  max = limit,
  .raw = FALSE
)

col_distribution(id, citations = TRUE, .raw = FALSE)

col_interaction(id, .raw = FALSE)

col_media(id, .raw = FALSE)

col_property(id, .raw = FALSE)

col_relation(id, .raw = FALSE)

col_usage_metrics(id, .raw = FALSE)

col_tree(
  id = NULL,
  extinct = TRUE,
  ...,
  limit = 100L,
  max = limit,
  .raw = FALSE
)

col_children(id, extinct = TRUE, ..., limit = 100L, max = limit, .raw = FALSE)

Arguments

name, authorship, rank, code, server, data, max_active

See clb_match() and clb_match_checklist().

.raw

Return the raw parsed JSON instead of a tibble?

id

Usage or taxon id within the COL release.

q

Free-text query (or partial name for col_suggest()).

status

Taxonomic status filter.

...

Further query parameters forwarded to the underlying clb_*() function.

limit, max

Pagination controls, as in the clb_*() functions.

lang

ISO language filter for col_vernacular().

citations

Add reference_citation to col_distribution(), see clb_distribution().

extinct

Logical; include extinct taxa in tree navigation.

Value

As the corresponding clb_*() function.

Examples

if (FALSE) { # \dontrun{
col_match("Panthera leo")
col_usage_search("Felidae")
roots <- col_tree()
col_children(roots$id[1])
col_classification("4CGXP")
} # }