Exhaust all Researcher Degrees of Freedom in Parallel

Parse through a research design, iterating over all possible choices, thereby exhausting all documented researcher degrees of freedom. Uses the parallel package to enable parallel computing. Returns a data frame containing the results for all choice combinations.

Usage

exhaust_design_parallel(
  d,
  start_input,
  cl = NULL,
  libs = NULL,
  export = ls(globalenv()),
  weight = FALSE,
  est_by_cchoice = 10,
  verbose = FALSE
)

Arguments

d

A character vector of the research design steps function names

start_input

The input data for the first step.

cl

Either the return value of parallel::make_cluster() or the number of cores that you want the function to start. If cl is NULL then no clusters are used.

libs

The libraries that the design steps rely on.

export

The members of the environment that you want to export to the parallel cores. Defaults to all members of the global environment.

weight

Whether each step's choices should be weighted by their user assigned weights as included in the choice_type. Protocols with zero weight are excluded from the analysis. Defaults to FALSE.

est_by_cchoice

Each continuous choice will be evaluated by est_by_choice equally spaced steps, staring at valid_min and ending at valid_max.

verbose

Set to TRUE for some additional diagnostic output. Useful for large designs that take a while to process.

Value

A data frame containing results for all feasible choice permutations.

Details

See the vignette of the package for further details.

Examples

if (FALSE) {
  print("Sorry. No examples yet.")
}