% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/check_exotic_ants.R
\name{check_exotic_ants}
\alias{check_exotic_ants}
\title{Identify Exotic Ant Species (Brazil)}
\usage{
check_exotic_ants(
  comm,
  verbose = TRUE,
  plot = TRUE,
  plot_type = c("status", "species"),
  validate = TRUE,
  delay = 0.5
)
}
\arguments{
\item{comm}{A community matrix where species are columns and samples are rows.}

\item{verbose}{Logical; if \code{TRUE}, displays progress messages.}

\item{plot}{Logical; if \code{TRUE}, displays a plot (type controlled by \code{plot_type}).}

\item{plot_type}{Character; type of plot to display. \code{"status"} (default) shows a bar plot comparing
exotic vs. native abundance proportions. \code{"species"} shows a bar plot of individual exotic species
abundances as a proportion of the total community.}

\item{validate}{Logical; if \code{TRUE}, validates species names using GBIF before analysis.}

\item{delay}{Numeric; seconds to wait between GBIF API calls when \code{validate = TRUE}.}
}
\value{
Invisibly returns a list with two elements:
\item{table}{A data frame containing exotic species detected, with columns species, abundance, and percentage.}
\item{plot}{A ggplot2 object.}
}
\description{
Checks a community matrix for known exotic ant species in Brazil sourced from Vieira (2025).
}
