cvms (version 1.7.0)

update_hyperparameters: Check and update hyperparameters

Description

lifecycle::badge("experimental")

1. Checks if the required hyperparameters are present and throws an error when it is not the case.

2. Inserts the missing hyperparameters with the supplied default values.

For managing hyperparameters in custom model functions for cross_validate_fn() or validate_fn().

Usage

update_hyperparameters(..., hyperparameters, .required = NULL)

Value

A named list with the updated hyperparameters.

Arguments

...

Default values for missing hyperparameters.

E.g.:

kernel = "linear", cost = 10

hyperparameters

list of hyperparameters as supplied to cross_validate_fn(). Can also be a single-row data.frame.

.required

Names of required hyperparameters. If any of these are not present in the hyperparameters, an error is thrown.

Author

Ludvig Renbo Olsen,

See Also

Other example functions: model_functions(), predict_functions(), preprocess_functions()

Examples

# \donttest{
# Attach packages
library(cvms)

# Create a list of hyperparameters
hparams <- list(
  "kernel" = "radial",
  "scale" = TRUE
)

# Update hyperparameters with defaults
# Only 'cost' is changed as it's missing
update_hyperparameters(
  cost = 10,
  kernel = "linear",
  "scale" = FALSE,
  hyperparameters = hparams
)

# 'cost' is required
# throws error
if (requireNamespace("xpectr", quietly = TRUE)){
  xpectr::capture_side_effects(
    update_hyperparameters(
      kernel = "linear",
      "scale" = FALSE,
      hyperparameters = hparams,
      .required = "cost"
    )
  )
}

# }