SDMtune (version 1.1.0)

randomSearch: Random Search

Description

The function performs a random search in the hyperparameters space, creating a population of random models each one with a random combination of the provided hyperparameters values.

Usage

randomSearch(model, hypers, metric, test = NULL, pop = 20,
  env = NULL, parallel = FALSE, seed = NULL)

Arguments

model

'>SDMmodel or '>SDMmodelCV object.

hypers

named list containing the values of the hyperparameters that should be tuned, see details.

metric

character. The metric used to evaluate the models, possible values are: "auc", "tss" and "aicc".

test

'>SWD object. Test dataset used to evaluate the model, not used with aicc and '>SDMmodelCV objects, default is NULL.

pop

numeric. Size of the population, default is 20.

env

stack containing the environmental variables, used only with "aicc", default is NULL.

parallel

logical, if TRUE it uses parallel computation, default is FALSE. Used only with metric = "aicc", see details.

seed

numeric. The value used to set the seed to have consistent results, default is NULL.

Value

'>SDMtune object.

Details

• To know which hyperparameters can be tuned you can use the output of the function get_tunable_args. Hyperparameters not included in the hypers argument take the value that they have in the passed model.

• Parallel computation is used only during the execution of the predict function, and increases the speed only for large datasets. For small dataset it may result in a longer execution, due to the time necessary to create the cluster.

Examples

# NOT RUN {
# Acquire environmental variables
files <- list.files(path = file.path(system.file(package = "dismo"), "ex"),
                    pattern = "grd", full.names = TRUE)
predictors <- raster::stack(files)

# Prepare presence and background locations
p_coords <- virtualSp$presence
bg_coords <- virtualSp$background

# Create SWD object
data <- prepareSWD(species = "Virtual species", p = p_coords, a = bg_coords,
                   env = predictors, categorical = "biome")

# Split presence locations in training (80%) and testing (20%) datasets
datasets <- trainValTest(data, test = 0.2, only_presence = TRUE)
train <- datasets[[1]]
test <- datasets[[2]]

# Train a model
model <- train(method = "Maxnet", data = train, fc = "l")

# Define the hyperparameters to test
h <- list(reg = seq(0.2, 3, 0.2), fc = c("lqp", "lqph", "lh"))

# Run the function using as metric the AUC
output <- randomSearch(model, hypers = h, metric = "auc", test = test,
                       pop = 10, seed = 25)
output@results
output@models
# Order rusults by highest test AUC
output@results[order(-output@results$test_AUC), ]
# }