Extract Geographic Features from Occurrence Records

Calculates the number of occurrences, number of unique occurrences, mean latitude, mean longitude, latitudinal range, longitudinal range, eoo, aoo and hemisphere as input features for IUCNN from a list of species occurrences.

iucnn_geography_features(
  x,
  species = "species",
  lon = "decimallongitude",
  lat = "decimallatitude",
  rescale = TRUE,
  verbose = FALSE
)

Arguments

x

a data.frame of species occurrence records including three columns with species name, longitudinal coordinates and latitudinal coordinates (both decimal).

species

a character string. The name of the column with the species names.

lon

a character string. The name of the column with the longitude.

lat

a character string. The name of the column with the latitude.

rescale

logical. If TRUE, the geographic features are rescaled. This is recommended to run IUCNN, and the default. If FALSE, raw (human readable) feature values are returned.

verbose

logical. If TRUE, progress messages will be displayed. Default = FALSE.

Value

a data.frame of geographic features

Details

Coordinate ranges are 90% quantiles, for species with less than three occurrences EOO is set to AOO.

See also

Other Feature preparation: iucnn_bias_features(), iucnn_biome_features(), iucnn_climate_features(), iucnn_cnn_features(), iucnn_footprint_features(), iucnn_phylogenetic_features(), iucnn_prepare_features(), iucnn_prepare_phy()

Examples

if (FALSE) {
dat <- data.frame(species = c("A","B"),
                  decimallongitude = runif(200,10,15),
                  decimallatitude = runif(200,-5,5))

iucnn_geography_features(dat)
}