evaluate_by_row: Evaluate a simulation function on each row of a data frame or...

In simhelpers: Helper Functions for Simulation Studies

Evaluate a simulation function on each row of a data frame or tibble

Description

Evaluates a simulation function on each row of a data frame or tibble containing parameter values. Returns a single tibble with parameters and simulation results. The function uses furrr::future_pmap, which allows for easy parallelization.

Usage

evaluate_by_row(
  params,
  sim_function,
  ...,
  .progress = FALSE,
  .options = furrr::furrr_options(),
  system_time = TRUE
)

Arguments

params	data frame or tibble containing simulation parameter values. Each row should represent a separate set of parameter values.
sim_function	function to be evaluated, with argument names matching the variable names in params. The function must return a data.frame, tibble, or vector.
...	additional arguments passed to sim_function.
.progress	A single logical. Should a progress bar be displayed? Only works with multisession, multicore, and multiprocess futures. Note that if a multicore/multisession future falls back to sequential, then a progress bar will not be displayed. Warning: The .progress argument will be deprecated and removed in a future version of furrr in favor of using the more robust progressr package.
.options	The future specific options to use with the workers. This must be the result from a call to furrr_options().
system_time	logical indicating whether to print computation time. TRUE by default.

Value

A tibble containing parameter values and simulation results.

Examples

df <- data.frame(
  n = 3:5,
  lambda = seq(8, 16, 4)
)

evaluate_by_row(df, rpois)

simhelpers documentation built on May 4, 2022, 1:05 a.m.