Diff of /man/biomkrAccrualSim.Rd [000000] .. [d9ee58]

Switch to side-by-side view

--- a
+++ b/man/biomkrAccrualSim.Rd
@@ -0,0 +1,96 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/utils-batches.R
+\name{biomkrAccrualSim}
+\alias{biomkrAccrualSim}
+\title{Run a number of batches of recruitment prediction and
+collect summary statistics on arm closures, and final
+recruitment totals for all experimental and control arms}
+\usage{
+biomkrAccrualSim(
+  n = 100,
+  centres_file = "centres.csv",
+  arms_file = "arms.json",
+  data_path = "extdata/",
+  output_path = "../biomkrAccrual_output_data/",
+  figs_path = paste0(output_path, "figures/"),
+  accrual_period = 50/4,
+  interim_period = 25/4,
+  precision = 10,
+  ctrl_ratio = c(1, 1),
+  target_arm_size = 60,
+  target_interim = target_arm_size/2,
+  target_control = 180,
+  target_interim_control = target_control/2,
+  shared_control = TRUE,
+  fixed_centre_starts = TRUE,
+  fixed_site_rates = FALSE,
+  fixed_region_prevalences = FALSE,
+  quietly = TRUE,
+  keep_files = FALSE
+)
+}
+\arguments{
+\item{n}{Number of instances to run (defaults to 100)}
+
+\item{centres_file}{File containing recruitment centre data
+(defaults to "centres.csv")}
+
+\item{arms_file}{File containing list of which recruitment
+arms recruit to which experimental arm}
+
+\item{data_path}{Folder where \code{centres_file}, \code{prop_file} and
+\code{arms_file} are located. Defaults to the location of the package
+example data in the package installation; this should be changed.}
+
+\item{output_path}{Folder where data generated during execution
+will be stored; defaults to \verb{../biomkrAccrual_output_data/}.}
+
+\item{figs_path}{Folder where figures generated during execution
+will be stored; defaults to the \code{figures} subdirectory in
+\code{output_path}.}
+
+\item{accrual_period}{Maximum number of weeks to recruit
+(defaults to 80)}
+
+\item{target_arm_size}{Maximum size for all experimental arms
+(defaults to 308)}
+
+\item{target_interim}{Recruitment target for experimental arms
+at interim analysis; defaults to \code{target_arm_size / 2}.}
+
+\item{target_control}{Maximum size for all control arms
+(defaults to 308)}
+
+\item{target_interim_control}{Recruitment target for control arms
+at interim analysis; defaults to \code{target_control / 2}.}
+
+\item{shared_control}{= TRUE,}
+
+\item{fixed_centre_starts}{TRUE if centres are assumed to start
+exactly when planned; FALSE if some randomisation should be added.}
+
+\item{fixed_site_rates}{TRUE if centre recruitment rates should
+be treated as exact; FALSE if they should be drawn from a gamma
+distribution with a mean of the specified rate.}
+
+\item{fixed_region_prevalences}{TRUE if biomarker prevalences
+should be considered to be identical for all sites within a
+region; FALSE if they should be drawn from a Dirichlet distribution
+with a mean of the specified prevalence.}
+
+\item{quietly}{If TRUE, do not display information and plots from
+individual runs within the batch. Defaults to TRUE.}
+
+\item{keep_files}{If FALSE, do not save data or plots from individual
+runs within the batch.  Defaults to FALSE.}
+}
+\value{
+Dataframe of site closing times
+
+Dataframe of experimental arm totals
+}
+\description{
+Run a number of batches of recruitment prediction and
+collect summary statistics on arm closures, and final
+recruitment totals for all experimental and control arms
+}