generateEcoSelection: Select relivent ecoregions

In GapAnalysis: Conservation Indicators Using Spatial Information

Select relivent ecoregions

Description

Utilizes the occurrence data location to select all ecoregions that intersect with thoses points. Helpful as it reduces the overall file size of the ecoregion object.

Usage

generateEcoSelection(taxon, occurrenceData, ecoregions, idColumn)

Arguments

taxon	A character object that defines the name of the species as listed in the occurrence dataset
occurrenceData	a data frame of values containing columns for the taxon, latitude, longitude, and type
ecoregions	A terra vect object the contains spatial information on all ecoregions of interests
idColumn	A character vector that notes what column within the ecoregions object should be used as a unique ID

Value

selectedEcos : a terra vect that contains the selected ecoregion features

References

Khoury et al. (2019) Ecological Indicators 98:420-429. \Sexpr[results=rd]{tools:::Rd_expr_doi("10.1016/j.ecolind.2018.11.016")} Carver et al. (2021) GapAnalysis: an R package to calculate conservation indicators using spatial information

Examples

##Obtaining occurrences from example
data(CucurbitaData)
## ecoregion features
data(ecoregions)

# convert the dataset for function
taxon <- "Cucurbita_cordata"
occurrenceData <- CucurbitaData
ecoregions <- terra::vect(ecoregions)

#Running generateEcoSelection
selectedEcos <- generateEcoSelection(taxon = taxon,
                    occurrenceData = occurrenceData,
                    ecoregions = ecoregions,
                    idColumn = "ECO_NAME"
                    )

GapAnalysis documentation built on May 12, 2026, 5:07 p.m.