check_exotic_ants: Identify Exotic Ant Species (Brazil)

In AntClassify: Functional Guilds, Invasion Status, Endemism, and Rarity of Ants

Identify Exotic Ant Species (Brazil)

Description

Checks a community matrix for known exotic ant species in Brazil sourced from Vieira (2025).

Usage

check_exotic_ants(
  comm,
  verbose = TRUE,
  plot = TRUE,
  plot_type = c("status", "species"),
  validate = TRUE,
  delay = 0.5
)

Arguments

comm	A community matrix where species are columns and samples are rows.
verbose	Logical; if TRUE, displays progress messages.
plot	Logical; if TRUE, displays a plot (type controlled by plot_type).
plot_type	Character; type of plot to display. "status" (default) shows a bar plot comparing exotic vs. native abundance proportions. "species" shows a bar plot of individual exotic species abundances as a proportion of the total community.
validate	Logical; if TRUE, validates species names using GBIF before analysis.
delay	Numeric; seconds to wait between GBIF API calls when validate = TRUE.

Value

Invisibly returns a list with two elements:

table	A data frame containing exotic species detected, with columns species, abundance, and percentage.
plot	A ggplot2 object.

AntClassify documentation built on Sept. 4, 2026, 1:06 a.m.