italic_occurrences: Get occurrence records for lichen taxa

In ritalic: Interface to the ITALIC Database of Lichen Biodiversity

Get occurrence records for lichen taxa

Description

Retrieves occurrence records from Italian herbarium collections for specified lichen taxa. Only accepts names that exist in the database of ITALIC.

Usage

italic_occurrences(sp_names, result_data = "simple")

Arguments

sp_names	Character vector of accepted names
result_data	Character string specifying output detail level: "simple" (default) or "extended"

Value

A data frame with occurrence records. Column names follow the Darwin Core standard, with the additional column substratum, which is particularly relevant for lichens. For simple output:

scientificName

The scientific name provided as input

decimalLatitude

Latitude in decimal degrees

decimalLongitude

Longitude in decimal degrees

coordinatesUncertaintyInMeters

Spatial uncertainty of the coordinates

substratum

Substrate on which the specimen was found

institutionCode

Code of the herbarium holding the specimen

eventDate

Collection date

Extended output adds:

locality

Collection locality

catalogNumber

Specimen identifier in the collection

minimumElevationInMeters

Lower limit of the elevation range

maximumElevationInMeters

Upper limit of the elevation range

verbatimIdentification

Scientific name reported on the original label

identifiedBy

Person who identified the specimen

Note

Before using this function with a list of names, first obtain their accepted names using italic_match(). Example workflow:

      names_matched <- italic_match(your_names)
      occ <- italic_occurrences(names_matched$accepted_name)
      

References

ITALIC - The Information System on Italian Lichens https://italic.units.it

Examples

## Not run: 
# Get simple occurrence data
italic_occurrences("Cetraria ericetorum Opiz")

# Get extended occurrence data
occ_ext <- italic_occurrences("Cetraria ericetorum Opiz", result_data = "extended")

# Then get citations for the retrieved occurrences
italic_occurrences_references(occ_ext)

## End(Not run)

ritalic documentation built on April 3, 2025, 10:27 p.m.