Extract Human Footprint Index Features from Occurrence Records

Bins the human footprint index into a set of bins and the fraction of occurrence records of a species in each bin are the features. By default the human footprint index is downloaded from https://wcshumanfootprint.org/. THIS FUNCTION WILL DOWNLOAD DATA FROM THE INTERNET AND SAVE IT TO THE WORKING DIRECTORY. The data files are >200 MB each and downloading may take some time on first execution.

iucnn_footprint_features(
  x,
  footp_input = NULL,
  species = "species",
  lon = "decimallongitude",
  lat = "decimallatitude",
  rescale = TRUE,
  year = c(1993, 2009),
  download_folder = "feature_extraction",
  breaks = c(0, 0.81, 1.6, 2.3, 100),
  verbose = FALSE
)

Source

https://wcshumanfootprint.org/

Arguments

x

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

footp_input

an object of the class SpatRaster with values for the human footprint index. If the SpatRaster object has two or more layers, different layers are interpreted as different time-slices.

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 values are rescaled using natural logarithm transformation. If FALSE, remember to change the breaks argument.

year

numeric. The years for which to obtain the human footprint index. The default is to the two layers available. Can be a either year, in case only one slice is desired. Other time slices are currently not supported,

download_folder

character string. The folder were to save the data used for feature extraction. Relative to the working directory. Set to NULL for the working directory

breaks

numerical. The breaks to bin the human footprint index for the final features. The defaults are empirical values for the global footprint and rescale=TRUE. For custom values ensure that they cover the whole value range and are adapted to the value of rescale.

verbose

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

Value

a data.frame of human footprint features

Details

By default four categories of increasing human footprint index ( 1 = lowest, 4 = highest) are selected and rescaled.

See also

Other Feature preparation: iucnn_bias_features(), iucnn_biome_features(), iucnn_climate_features(), iucnn_cnn_features(), iucnn_geography_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_footprint_features(dat)
}