| Title: | Tidy Interfaces for Tabular Deep Learning |
|---|---|
| Description: | Model definitions for fitting, tuning, and predicting with deep learning models for tabular data using the 'parsnip' and 'tidymodels' frameworks. Supported models include the TabPFN foundation model of Hollmann et al. (2025) <doi:10.1038/s41586-024-08328-6>, TabICL by Qu et al. (2025) <doi:10.48550/arXiv.2502.05564>, SAINT by Somepalli et al. (2021) <doi:10.48550/arXiv.2106.01342>, and the tabular ResNet of Gorishniy et al. (2021) <doi:10.48550/arXiv.2106.11959>, among others. Helper functions are also included to create space-filling grids for tuning parameters that are defined on a per-layer basis. These functions define the model interfaces; the computations are carried out by separate engine packages built on 'torch'. |
| Authors: | Max Kuhn [aut, cre] (ORCID: <https://orcid.org/0000-0003-2402-136X>), Edgar Ruiz [aut], Posit Software, PBC [cph, fnd] (ROR: <https://ror.org/03wc8by49>) |
| Maintainer: | Max Kuhn <[email protected]> |
| License: | MIT + file LICENSE |
| Version: | 0.0.1 |
| Built: | 2026-10-16 12:39:10 UTC |
| Source: | https://github.com/tidymodels/tabby |
Model predictions across many sub-models
## S3 method for class ''_brulee_auto_int'' multi_predict(object, new_data, type = NULL, epochs = NULL, ...) ## S3 method for class ''_brulee_resnet'' multi_predict(object, new_data, type = NULL, epochs = NULL, ...) ## S3 method for class ''_brulee_rln'' multi_predict(object, new_data, type = NULL, epochs = NULL, ...)## S3 method for class ''_brulee_auto_int'' multi_predict(object, new_data, type = NULL, epochs = NULL, ...) ## S3 method for class ''_brulee_resnet'' multi_predict(object, new_data, type = NULL, epochs = NULL, ...) ## S3 method for class ''_brulee_rln'' multi_predict(object, new_data, type = NULL, epochs = NULL, ...)
object |
A model fit. |
new_data |
A rectangular data object, such as a data frame. |
type |
A single character value or
When |
epochs |
An integer vector for the number of training epochs. |
... |
Optional arguments to pass to |
A tibble with the same number of rows as new_data. Its .pred
column is a list of tibbles, each containing the predictions for the
corresponding row of new_data across the requested values of epochs.
neural_net_grid_space_filling() takes the number of layers in a neural
network as an input, creates a space-filling design with the multidimensional
layer parameter(s), and collapses the grid into list parameters that the
model function needs. expand_list_parameters() is a convenience function
that converts the list columns to a wide structure for printing,
visualization, etc.
neural_net_grid_space_filling( wflow, num_layers = 3, size = 10, param_info = NULL, range = c(2, 50), collapse = TRUE ) expand_list_parameters(x, pattern = "*")neural_net_grid_space_filling( wflow, num_layers = 3, size = 10, param_info = NULL, range = c(2, 50), collapse = TRUE ) expand_list_parameters(x, pattern = "*")
wflow |
A model specification or |
num_layers |
A single integer for the number of layers containing hidden units. |
size |
The minimum grid size. It may be adjusted upwards to find a feasible design. |
param_info |
A |
range |
A range for the number of hidden units in each layer. |
collapse |
A single logical for whether to collapse the parameters into list columns. |
x |
A data frame of grid points, some of which are list columns. |
pattern |
A regular expression pattern to select which list columns should be expanded to a wide format. |
neural_net_grid_space_filling() returns a tibble with grid points,
some of which are list-columns containing integer vectors.
expand_list_parameters() returns a tibble where the selected list columns
are replaced by one integer column per layer.
rn_spec <- tabular_resnet(hidden_units = tune(), bottleneck_units = tune(), penalty = tune()) rn_grid <- neural_net_grid_space_filling(rn_spec) rn_grid rn_grid |> expand_list_parameters()rn_spec <- tabular_resnet(hidden_units = tune(), bottleneck_units = tune(), penalty = tune()) rn_grid <- neural_net_grid_space_filling(rn_spec) rn_grid rn_grid |> expand_list_parameters()