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

Switch to side-by-side view

--- a
+++ b/man/biomkrAccrual.Rd
@@ -0,0 +1,103 @@
+% Generated by roxygen2: do not edit by hand
+% Please edit documentation in R/spine.R
+\name{biomkrAccrual}
+\alias{biomkrAccrual}
+\title{Command line}
+\usage{
+biomkrAccrual(
+  target_arm_size = 60,
+  target_interim = target_arm_size/2,
+  target_control = 180,
+  shared_control = TRUE,
+  accrual_period = 50/4,
+  interim_period = accrual_period/2,
+  precision = 10,
+  ctrl_ratio = c(1, 1),
+  centres_file = "centres.csv",
+  prop_file = "proportions.csv",
+  arms_file = "arms.json",
+  data_path = "extdata/",
+  output_path = "../biomkrAccrual_output_data/",
+  figs_path = paste0(output_path, "figures/"),
+  fixed_centre_starts = TRUE,
+  fixed_site_rates = FALSE,
+  fixed_region_prevalences = FALSE,
+  quietly = FALSE,
+  keep_files = TRUE
+)
+}
+\arguments{
+\item{target_arm_size}{Number of patients required per
+treatment arm}
+
+\item{target_interim}{Number of patients required per
+arm for interim analysis; defaults to \verb{target_arm_size \\ 2}}
+
+\item{target_control}{Number of patients required for the
+control arm(s)}
+
+\item{shared_control}{TRUE if all treatment arms share the
+same control arm; FALSE if each treatment arm has its own
+control. Defaults to TRUE.}
+
+\item{accrual_period}{Recruitment period (months).}
+
+\item{interim_period}{Recruitment period to interim (months).}
+
+\item{precision}{For the Dirichlet model of biomarker prevalences,
+variability decreases as precision increases. Defaults to 10.}
+
+\item{ctrl_ratio}{Ratio of patient allocation to treatment arm
+versus control for all active arms; defaults to c(1, 1).}
+
+\item{centres_file}{Name of CSV file with information about
+each recruitment centre; this should have columns "site",
+"start_month", "mean_rate", "region" and optionally "site_cap"
+if recruitment is capped per site. Defaults to \code{centres.csv}.}
+
+\item{prop_file}{Name of CSV file with expected biomarker prevalences
+for each region; this should have one column "category", naming
+the biomarkers or biomarker combinations, and one column per
+region. Defaults to \code{proportions.csv}.}
+
+\item{arms_file}{Name of JSON file describing which recruitment
+arms (defined by biomarkers) recruit to which treatment arms.
+Defaults to \code{arms_json}.}
+
+\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{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}{Defaults to FALSE, which displays the output from
+each run. Set to TRUE to generate data and figures without displaying
+them.}
+
+\item{keep_files}{Save data files and plots generated during the run.
+Defaults to TRUE.}
+}
+\description{
+Command line
+}
+\examples{
+biomkrAccrual()
+
+}