minosse.target: The target species geographic range computation.

Description Usage Arguments Details Value Author(s) Examples

View source: R/minosse.target.R

Description

This function reconstructs the target species geographic range and probability distribution raster maps.

Usage

1
2
minosse.target(resp,predictors,bkg="presence",min.bkg=NULL,n.sims=10,
n.folds=1,sampling.by.distance=TRUE,n.sims.clusters="automatic",seed=NULL)

Arguments

resp

The target species occurrence record. Usually the first element list in the minosse.data output.

predictors

The predictor species raster stack. Usually the second element list in the minosse.data output.

bkg

The number of pseudo absences to be simulated for each predictor species. If "presence", minosse.data generates as many pseudo absences the presences in each species.

min.bkg

Numeric. If bkg.predictors is set to "presence", this is the minimum number of pseudo absences to simulate if a species occurrence number is below this value.

n.sims

Numeric. The number of pseudo absences simulations (see details).

n.folds

Numeric. The number of folds for AUC-based cross-validation of Regression Kriging predictions. Default 1.

sampling.by.distance

Logical. If TRUE pseudo absences are simulated with an intensity proportional to the distance to the presence data. If FALSE a pure spatial random distribution is simulated.

n.sims.clusters

Numeric. The number of machine cores to use when setting multiple pseudo absences simulations. Default "automatic".

seed

Numeric. The seed to use for experiment replication.

Details

For Machine Learning Algorithms Barbet & Masin (https://doi.org/10.1111/j.2041-210X.2011.00172.x) suggest using as many pseudo absences as the number of the presences. For very poor occurrence datasets (with less than 1000 presences), they suggest performing multiple (10 at least) pseudo absences simulations and then averaging the derived predictions. minosse.target function allows fully complying with these authors' suggestions.

Value

a list of 7 objects is returned. The first item of the list is a list of 12 geographic range maps obtained by binarizing Regression Kriging output by means of an equivalent number of threshold values. The second element of the list is the probability map yielded by Regression Kriging. The third element is a list containing eXtreme Gradient Boosting model and validation statistics for each of the replicates of the pseudo absences simulations (n.sims, see above). The fourth element of the list shows the Regression Kriging binarization threshold values. The fifth element (validation) shows the Regression Kriging prediction (RMSE and total explained variance) and xgboost model validations (squared R and RMSE). The two last elements show the target species name and the occurence record.

Author(s)

Francesco Carotenuto, francesco.carotenuto@unina.it

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
  
  library(raster)
  data(lgm)
  raster(system.file("exdata/prediction_ground.gri", package="DeepTime"))->prediction_ground

  minosse_dat<-minosse.data(obj=lgm,species_name="Mammuthus_primigenius",
  domain="land",coc.by="locality",min.occs=3,abiotic.covs=NULL,
  combine.covs=FALSE,reduce_covs_by="pca",covs_th=0.95,c.size="mean",
  bkg.predictors="presence",min.bkg=100,sampling.by.distance=TRUE,
  crop.by.mcp=FALSE,prediction.ground=prediction_ground,projection=NULL,
  lon_0=NULL,lat_0=NULL,n.clusters="automatic",seed=625)

  minosse_res<-minosse.target(resp=minosse_dat[[1]],predictors=minosse_dat[[2]],
  bkg="presence", min.bkg = 100,n.sims=10,n.folds=1,sampling.by.distance=TRUE,
  n.sims.clusters="automatic",seed=625)

  

francesco-carotenuto/DeepTime documentation built on Dec. 16, 2019, 12:40 a.m.