Skip to contents

Update taxonomy from SHARK via SLU Artdatabanken API (Dyntaxa)

Source: R/dyntaxa_api_functions.R
update_dyntaxa_taxonomy.Rd

This function updates Dyntaxa taxonomy records based on a list of Dyntaxa taxon IDs. It collects parent IDs from SLU Artdatabanken API (Dyntaxa), retrieves full taxonomy records, and organizes the data into a full taxonomic table that can be joined with data downloaded from SHARK

Usage

update_dyntaxa_taxonomy(
  dyntaxa_ids,
  subscription_key,
  add_missing_taxa = FALSE,
  verbose = TRUE
)

Arguments

dyntaxa_ids

A vector of Dyntaxa taxon IDs to update.

subscription_key

A character string containing the subscription key for accessing the SLU Artdatabanken API for Dyntaxa. A key is provided for registered users at SLU Artdatabanken.

add_missing_taxa

Logical. If TRUE, the function will attempt to fetch missing taxa (i.e., taxon_ids not found in the initial Dyntaxa DwC-A query). Default is FALSE.

verbose

Logical. Print progress messages. Default is TRUE.

Value

A data frame representing the updated Dyntaxa taxonomy table.

Details

Note: Please review the API conditions and register for access before using the API. Data collected through the API is stored at SLU Artdatabanken. Please also note that the authors of SHARK4R are not affiliated with SLU Artdatabanken.

See also

get_shark_data, update_worms_taxonomy, SLU Artdatabanken API Documentation

Examples

if (FALSE) { # \dontrun{
# Update Dyntaxa taxonomy for taxon IDs 238366 and 1010380
updated_taxonomy <- update_dyntaxa_taxonomy(c(238366, 1010380), "your_subscription_key")
print(updated_taxonomy)
} # }