teal.picks

teal.picks is an R package used in the development of teal applications. It provides:

• a hierarchical choices / selected model for datasets, variables, and values in a Shiny session, with optional tidyselect support for dynamic choices,
• picks_ui and picks_srv modules to collect those selections interactively,
• merge_srv and tm_merge to merge teal data according to user picks,
• conversion helpers such as as.picks to align with teal.transform objects.

Installation

install.packages('teal.picks')

Alternatively, you might want to use the development version.

# install.packages("pak")
# pak::pak("insightsengineering/teal.picks")
install.packages("teal.picks", repos = c('https://insightsengineering.r-universe.dev', 'https://cloud.r-project.org'))

Usage

See the package reference for full documentation.

Below is a minimal illustration of defining a picks specification (datasets, then variables; optional values() when needed):

library(teal.picks)

my_picks <- picks(
  datasets(choices = c("iris", "mtcars")),
  variables(
    choices = tidyselect::everything(),
    selected = 1L,
    multiple = TRUE
  )
)

Wire my_picks into picks_ui / picks_srv with a reactive teal_data object, or use tm_merge inside a teal::init() application. Full patterns are documented on the package site.

Getting help

If you encounter a bug or have a feature request, please file an issue. For questions, discussions, and staying up to date, please use the teal channel in the pharmaverse slack workspace.