R finetune control_sim_anneal 模拟退火搜索过程的控制方面

模拟退火搜索过程的控制方面

用法

control_sim_anneal(
  verbose = FALSE,
  verbose_iter = TRUE,
  no_improve = Inf,
  restart = 8L,
  radius = c(0.05, 0.15),
  flip = 3/4,
  cooling_coef = 0.02,
  extract = NULL,
  save_pred = FALSE,
  time_limit = NA,
  pkgs = NULL,
  save_workflow = FALSE,
  save_history = FALSE,
  event_level = "first",
  parallel_over = NULL,
  allow_par = TRUE,
  backend_options = NULL
)

参数

verbose

记录在单个 R 进程中训练期间生成的结果(始终显示的警告和错误除外)的逻辑。当使用大多数并行后端时，此参数通常不会导致任何日志记录。如果使用深色 IDE 主题，某些日志消息可能很难看到；尝试使用 options(tidymodels.dark = TRUE) 设置 tidymodels.dark 选项以打印较浅的颜色。

verbose_iter

用于记录搜索过程结果的逻辑。默认为 FALSE。如果使用深色 IDE 主题，某些日志消息可能很难看到；尝试使用 options(tidymodels.dark = TRUE) 设置 tidymodels.dark 选项以打印较浅的颜色。

no_improve

没有更好结果的迭代次数的整数截止值。

restart

在从最后的整体最佳条件生成新的调整参数候选之前没有改进的迭代次数。

radius

(0, 1) 上的两个实数说明了当前结果的“邻域”值应该是什么。如果所有数字参数都缩放为 [0, 1] 比例，则这些值将设置最小值。和最大。用于生成新数值参数值的圆的半径。

flip

[0, 1] 之间的实数，表示每次迭代时更改任何非数字参数值的概率。

cooling_coef

影响冷却计划的真实正数。较大的值会降低接受次优参数设置的可能性。

extract

具有至少一个参数(或 NULL )的可选函数，可用于保留模型拟合对象、配方或工作流其他元素中的任意对象。

save_pred

是否应为每个评估的模型保存 out-of-sample 预测的逻辑。

time_limit

函数应执行的最小分钟数(已过去)的数字。在内部检查点评估经过的时间，如果超过时间，则返回当时的结果(带有警告)。这意味着time_limit不是一个确切的限制，而是一个最短时间限制。

pkgs

在并行处理期间应加载(按命名空间)的 R 包名称的可选字符串。

save_workflow

工作流是否应作为属性附加到输出的逻辑。

save_history

保存搜索迭代细节的逻辑。这些保存到名为 sa_history.RData 的 tempdir() 中。当 R 会话结束时，这些结果将被删除。此选项仅用于教学目的。

event_level

包含 "first" 或 "second" 的单个字符串。当进行任何类型的类预测时，此参数将传递给尺度度量函数，并指定哪个级别的结果被视为 "event"。

parallel_over

包含 "resamples" 或 "everything" 的单个字符串，说明如何使用并行处理。或者，允许 NULL，它会自动在 "resamples" 和 "everything" 之间进行选择。

如果是 "resamples" ，则调整将仅通过重采样并行执行。在每次重新采样中，预处理器(即配方或公式)都会处理一次，然后在需要拟合的所有模型中重复使用。

如果"everything"，则调整将在两个级别并行执行。外部并行循环将迭代重新采样。此外，内部并行循环将迭代该特定重采样的预处理器和模型调整参数的所有独特组合。这将导致预处理器被重新处理多次，但如果处理速度非常快，则速度会更快。

如果 NULL ，如果有多次重新采样，则选择 "resamples"，否则选择 "everything" 以尝试最大化核心利用率。

请注意，parallel_over 策略之间的切换不保证使用相同的随机数生成方案。但是，使用相同的 parallel_over 策略重新调整模型可以保证在运行之间可重现。

allow_par

允许并行处理的逻辑(如果注册了并行后端)。

backend_options

由 tune::new_backend_options() 创建的类 "tune_backend_options" 的对象，用于将参数传递给特定的调整后端。默认后端选项默认为NULL。

值

类 control_sim_anneal 的对象，它回显参数值。

例子

control_sim_anneal()
#> Simulated annealing control object