Skip to contents

Add naturalized alien flora status (GloNAF)

Source: R/add-glonaf.R
add_glonaf.Rd

Joins GloNAF (Global Naturalized Alien Flora) data to a taxify() result, filtered by region.

Usage

add_glonaf(x, region, verbose = TRUE)

Arguments

x

A data.frame returned by taxify().

region

Character. GloNAF region identifier(s), or "all". Regions are ISO 3166 alpha-3 country codes extended with dot notation for sub-national units (e.g., "DEU" for Germany, "USA.CA" for California). List them with enrichment_groups("glonaf").

  • Single region: adds naturalized column (no suffix).

  • Multiple regions: adds naturalized_<region> columns.

  • "all": adds one column per region in the dataset.

verbose

Logical. Default TRUE.

Value

The same data.frame with additional column(s):

naturalized

1 if the species is recorded as naturalized in that region, NA otherwise.

Details

Source: GloNAF v2.0 (van Kleunen et al. 2019, Davis et al. 2025, CC BY 4.0). Coverage: ~16k alien plant taxa across ~1,300 regions. Plants only.

References

van Kleunen M et al. (2019) The Global Naturalized Alien Flora (GloNAF) database. Ecology 100:e02542. doi:10.1002/ecy.2542

Davis AJS et al. (2025) The updated Global Naturalized Alien Flora (GloNAF 2.0) database. Ecology 106:e70245. doi:10.1002/ecy.70245

Examples

# Runs offline against the bundled example database.
old <- options(taxify.data_dir = taxify_example_data())

taxify("Robinia pseudoacacia") |>
  add_glonaf(region = "DEU")

taxify("Robinia pseudoacacia") |>
  add_glonaf(region = c("DEU", "AUT"))

options(old)