italic_ecoregions_distribution: Get distribution of lichen taxa across Italian ecoregions

In ritalic: Interface to the ITALIC Database of Lichen Biodiversity

Get distribution of lichen taxa across Italian ecoregions

Description

Returns the distribution and commonness status of lichen taxa across Italian ecoregions. Only accepts names that exist in the database of ITALIC.

Usage

italic_ecoregions_distribution(sp_names, result_data = "rarity")

Arguments

sp_names	Character vector of accepted names
result_data	Character string specifying the output format: "rarity" (default) returns commonness/rarity categories, "presence-absence" returns only values for presence/absence (0/1)

Value

A data frame with:

scientific_name

The scientific name provided as input

alpine

Status in alpine belt (extremely common to absent)

subalpine

Status in subalpine belt (extremely common to absent)

oromediterranean

Status in oromediterranean belt (extremely common to absent)

montane

Status in montane belt (extremely common to absent)

dry_submediterranean

Status in dry submediterranean belt (extremely common to absent)

padanian

Status in padanian belt (extremely common to absent)

humid_submediterranean

Status in humid submediterranean belt (extremely common to absent)

humid_mediterranean

Status in humid mediterranean belt (extremely common to absent)

dry_mediterranean

Status in dry mediterranean belt (extremely common to absent)

The possible values of commonness/rarity are: "extremely common", "very common", "common", "rather common", "rather rare", "rare", "very rare", "extremely rare", "absent"

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)
      ecoregions_distribution <- italic_ecoregions_distribution(names_matched$accepted_name)
      

References

For more information about Italian ecoregions see ITALIC ecoregions distribution https://italic.units.it/?procedure=base&t=59&c=60#commonness and the scientific publication describing the ecoregions https://www.mdpi.com/1424-2818/12/8/294

Examples

## Not run: 
# Get commonness/rarity categories
italic_ecoregions_distribution("Cetraria ericetorum Opiz")

# Get presence/absence data
italic_ecoregions_distribution("Cetraria ericetorum Opiz", result_data="presence-absence")

## End(Not run)

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