Nothing
#' Possible engine parameters for catboost
#'
#' These parameters are auxiliary to tree-based models that use the "catboost"
#' engine. They correspond to tuning parameters that would be specified using
#' `set_engine("catboost", ...)`.
#'
#' "catboost" is an available engine in the parsnip extension package
#' [bonsai](https://bonsai.tidymodels.org/)
#'
#' @inheritParams Laplace
#' @param values A character string of possible values. See
#' `values_grow_policy` in examples below.
#' @details
#' The parameters are:
#'
#' - `l2_leaf_reg()`: the L2 regularization coefficient for the leaf values.
#' - `max_leaves()`: the maximum number of terminal nodes in a tree.
#' - `grow_policy()`: the method for growing trees. `"SymmetricTree"` (the
#' default in catboost) splits every node at a given depth using the same
#' condition. `"Depthwise"` grows the tree level-by-level, choosing the best
#' split for each node. `"Lossguide"` grows the tree leaf-by-leaf, splitting
#' the leaf with the best loss improvement.
#' - `one_hot_max_size()`: categorical predictors with this many distinct
#' values or fewer are one-hot encoded. Those with more values are encoded
#' using target statistics.
#' - `score_randomness()`: a multiplier for the amount of Gaussian noise added
#' to the splitting score (zero means no additional noise).
#'
#' ## Conditional constraints
#'
#' Several catboost parameters are only used for specific values of other
#' parameters. Using the dials parameter names:
#'
#' - `max_leaves()` is only used when `grow_policy()` is `"Lossguide"`.
#' catboost will fail with an error for other grow policies.
#' - `min_n()` (`min_data_in_leaf` in catboost) is only used when
#' `grow_policy()` is `"Depthwise"` or `"Lossguide"`. For `"SymmetricTree"`,
#' it is silently ignored.
#' - `tree_depth()` is used for all grow policies, but its effect differs.
#' For `"SymmetricTree"`, each tree has exactly `2^tree_depth` terminal
#' nodes. For `"Lossguide"`, it is a cap on the depth of any branch while
#' `max_leaves()` controls the tree size. catboost's maximum depth is 16.
#' - `sample_prop()` (`subsample` in catboost) cannot be used with Bayesian
#' bootstrapping. Bayesian bootstrapping is catboost's default for
#' multiclass outcomes, so catboost will fail with an error in that case
#' unless a different `bootstrap_type` is set as an engine argument.
#' - `one_hot_max_size()` only affects predictors that are passed to catboost
#' as factors. If categorical predictors are converted to indicator
#' variables beforehand (e.g., with a recipe), it has no effect.
#' - `mtry_prop()` (`rsm` in catboost) is only supported on the CPU, except for
#' pairwise ranking models.
#'
#' For more information, see the [catboost webpage](https://catboost.ai/docs/en/references/training-parameters/).
#' @examples
#'
#' l2_leaf_reg()
#' max_leaves()
#' values_grow_policy
#' grow_policy()
#' one_hot_max_size()
#' score_randomness()
#'
#' @rdname catboost_parameters
#' @export
l2_leaf_reg <- function(range = c(0, 1), trans = transform_log10()) {
new_quant_param(
type = "double",
range = range,
inclusive = c(TRUE, TRUE),
trans = trans,
label = c(l2_leaf_reg = "L2 Regularization Coefficient"),
finalize = NULL
)
}
#' @rdname catboost_parameters
#' @export
max_leaves <- function(range = c(10, 64), trans = NULL) {
new_quant_param(
type = "integer",
range = range,
inclusive = c(TRUE, TRUE),
trans = trans,
label = c(max_leaves = "Maximum Number of Leaves"),
finalize = NULL
)
}
#' @rdname catboost_parameters
#' @export
grow_policy <- function(values = values_grow_policy) {
new_qual_param(
type = "character",
values = values,
label = c(grow_policy = "Tree Growing Policy"),
finalize = NULL
)
}
#' @rdname catboost_parameters
#' @export
values_grow_policy <- c("SymmetricTree", "Depthwise", "Lossguide")
#' @rdname catboost_parameters
#' @export
one_hot_max_size <- function(range = c(1L, 25L), trans = NULL) {
new_quant_param(
type = "integer",
range = range,
inclusive = c(TRUE, TRUE),
trans = trans,
label = c(one_hot_max_size = "Maximum Levels for One-Hot Encoding"),
finalize = NULL
)
}
#' @rdname catboost_parameters
#' @export
score_randomness <- function(range = c(0.0, 1.5), trans = NULL) {
new_quant_param(
type = "double",
range = range,
inclusive = c(TRUE, TRUE),
trans = trans,
label = c(score_randomness = "Random Noise Level"),
finalize = NULL
)
}
Any scripts or data that you put into this service are public.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.