continueRecruitment {bhmbasket}

continueRecruitment

Description

This function continues the recruitment of subjects for a set of scenarios based on the Go / NoGo decisions in the simulated trial outcomes of said scenarios.

Usage

continueRecruitment(n_subjects_add_list, decisions_list, method_name)

Arguments

n_subjects_add_list

A list that contains for each scenario an integer vector for the number of subjects per cohort to be additionally recruited.

decisions_list

A list with decisions per scenario created with getGoDecisions

method_name

A string for the method name of the analysis the decisions are based on

Details

This function is intended to be used for analyses with the following work flow:
simulateScenarios() -> performAnalyses() -> getGoDecisions()->
continueRecruitment() -> performAnalyses() -> getGoDecisions()->
continueRecruitment() -> ...

Note that n_subjects_add_list takes the additional number of subjects to be recruited, not the overall number of subjects. This way the work flow can be repeated as often as required, which can be useful e.g. for interim analyses.

Value

An object of class scenario_list with the scenario data for each specified scenario.

Author(s)

Stephan Wojciekowski

See Also

simulateScenarios performAnalyses getGoDecisions

Examples

interim_scenarios <- simulateScenarios(
  n_subjects_list     = list(c(10, 20, 30)),
  response_rates_list = list(rep(0.9, 3)),
  n_trials            = 10)

interim_analyses <- performAnalyses(
  scenario_list       = interim_scenarios,
  target_rates        = rep(0.5, 3),
  n_mcmc_iterations   = 100)

interim_gos <- getGoDecisions(
  analyses_list       = interim_analyses,
  cohort_names        = c("p_1", "p_2", "p_3"),
  evidence_levels     = c(0.5, 0.8, 0.5),
  boundary_rules      = quote(c(x[1] > 0.8, x[2] > 0.6, x[3] > 0.7)))

scenarios_list <- continueRecruitment(
  n_subjects_add_list = list(c(30, 20, 10)),
  decisions_list      = interim_gos,
  method_name         = "exnex_adj")