italic_occurrences {ritalic} | R Documentation |
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)