tune 1.1.0
tune 1.1.0 introduces a number of new features and bug fixes, accompanied by various optimizations that substantially decrease the total evaluation time to tune hyperparameters in the tidymodels.
New features
-
Introduced a new function
fit_best()
that provides a shorthand interface to fit a final model after parameter tuning. (#586) -
Refined machinery for logging issues during tuning. Rather than printing out warnings and errors as they appear, the package will now only print unique tuning issues, updating a dynamic summary message that maintains counts of each unique issue. This feature is only enabled for tuning sequentially and can be manually toggled with the
verbose
option. (#588) -
Introduced
collect_extracts()
, a function for collecting extracted objects from tuning results. The format of results closely mirrorscollect_notes()
, where the extracted objects are contained in a list-column alongside the resample ID and workflow.config
. (#579)
Bug fixes
-
Fixed bug in
select_by_pct_loss()
where the model with the greatest loss within the limit was returned rather than the most simple model whose loss was within the limit. (#543) -
Fixed bug in
tune_bayes()
where.Last.tune.result
would return intermediate tuning results. (#613) -
Extended
show_best()
,select_best()
,select_by_one_std_error()
,select_by_pct_loss()
to accommodate metrics with a target value of zero (notably,yardstick::mpe()
andyardstick::msd()
). (#243)
Other changes
-
Implemented various optimizations in tune's backend that substantially decrease the total evaluation time to tune hyperparameters with the tidymodels. (#634, #635, #636, #637, #640, #641, #642, #648, #649, #653, #656, #657)
-
Allowed users to supply list-columns in
grid
arguments. This change allows for manually specifying grid values that must be contained in list-columns, like functions or lists. (#625) -
Clarified error messages in
select_by_*
functions. Error messages now only note entries in...
that are likely candidates for failure toarrange()
, and those error messages are no longer duplicated for each entry in...
. -
Improved condition handling for errors that occur during extraction from workflows. While messages and warnings were appropriately handled, errors occurring due to misspecified
extract()
functions being supplied tocontrol_*()
functions were silently caught. As with warnings, errors are now surfaced both during execution and atprint()
(#575). -
Moved forward with the deprecation of
parameters()
methods forworkflow
s,model_spec
s, andrecipes
. Each of these methods will now warn on every usage and will be defunct in a later release of the package. (#650) -
Various bug fixes and improvements to documentation.