bootstrap_parallel: Employ *parallel* parametric bootstrap to estimate rapidly...

Description Usage Arguments Value Author(s) References Examples

View source: R/bootstrap_parallel.R

Description

Employ *parallel* parametric bootstrap to estimate rapidly the variation in summary efficacy metrics.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
bootstrap_parallel(
  model_list,
  clean_DF,
  reference_Dunnett = NULL,
  full_inverse_function = NULL,
  metric = c("AUC", "ITGR", "linear", "AUC_pwl", "ITGR_pwl", "AUC_poly", "ITGR_poly"),
  progress = FALSE,
  bootstrap_statistic = c("AUC_originalScale", "Effect_Duration"),
  bootstrap_behavior = c("fixed", "random"),
  bootstrap_covariance_scale = 1,
  design_matrix = NULL,
  integral_grid_n = 101,
  xmin = NULL,
  xmax = NULL,
  x_time_spacing = 0.25,
  x_min_count_distinct = 10,
  norm_to_xrange = TRUE,
  K_boot = 1
)

Arguments

model_list

list from maeve::model_study().

clean_DF

data.frame. It should be "model_list$data$clean_DF_pred".

reference_Dunnett

character string with exact match to an element of grpnames. The exact match will be the reference group in Dunnett contrasts.

full_inverse_function

R function that inverts the response analyzed back to its original scale.

metric

character string describing which response curve summary metric to use.

progress

logical whether to print progress messages.

bootstrap_statistic

character string: Statistic for which the parametric bootstrap will assess uncertainty.

bootstrap_behavior

character string: Use fixed or random coefficient draws for parametric bootstrap? The "fixed" option is intended for testing.

bootstrap_covariance_scale

numeric scalar by which to scale multivariate Gaussian covariance matrix.

design_matrix

matrix of numerics with properly ordered design matrix from "predict( md, type = 'lpmatrix' )", where "md" is model extracted from model_list. This is found automatically if left as NULL (the default), but can be supplied by the user to speed up repeated execution, since it is typically unchanging within any given bootstrap simulation.

integral_grid_n

integer number of grid points for numerical integration.

xmin

numeric lower bound of range over which to evaluate the spline.

xmax

numeric upper bound of range over which to evaluate the spline.

x_time_spacing

spacing of time points across which to evaluate the splines. If time values are recorded as integers, then the default should be sufficient.

x_min_count_distinct

numeric integer. If the number of distinct x-values at which splines are evaluated is less than this, a warning is issued.

norm_to_xrange

logical for AUC calcuations: whether to normalize numeric definite integral to x-range.

K_boot

integer number of bootstrap samples to draw.

Value

An R data.frame with a number of summary metrics (one value per treatment group).

Author(s)

Bill Forrest <forrest@gene.com>

Bill Forrest forrest@gene.com

References

www.r-project.org

Examples

1
 cat('Currently no working example for bootstrap_parallel().')

wfforrest/maeve documentation built on Jan. 1, 2021, 12:47 p.m.