accrualReport: Accrual Report

In harrelfe/greport: Graphical Reporting for Clinical Trials

Accrual Report

Description

Generate graphics and LaTeX to analyze subject accrual

Usage

accrualReport(
  formula,
  data = NULL,
  subset = NULL,
  na.action = na.retain,
  dateRange = NULL,
  zoom = NULL,
  targetN = NULL,
  targetDate = NULL,
  closeDate = NULL,
  enrollmax = NULL,
  studynos = TRUE,
  minrand = 10,
  panel = "accrual",
  h = 2.5,
  w = 3.75,
  hb = 5,
  wb = 5,
  hdot = 3.5
)

Arguments

formula	formula object, with time variables on the left (separated by +) and grouping variables on the right. Enrollment date, randomization date, region, country, and site when present must have the variables in parenthesis preceeded by the key words enrollment, randomize, region, country, site.
data	data frame.
subset	a subsetting epression for the entire analysis.
na.action	a NA handling function for data frames, default is na.retain.
dateRange	Date or character 2-vector formatted as yyyy-mm-dd. Provides the range on the x-axis (before any zooming).
zoom	Date or character 2-vector for an option zoomed-in look at accrual.
targetN	integer vector with target sample sizes over time, same length as targetDate
targetDate	Date or character vector corresponding to targetN
closeDate	Date or characterstring. Used for randomizations per month and per site-month - contains the dataset closing date to be able to compute the number of dates that a group (country, site, etc.) has been online since randomizating its first subject.
enrollmax	numeric specifying the upper y-axis limit for cumulative enrollment when not zoomed
studynos	logical. Set to FALSE to suppress summary study numbers table.
minrand	integer. Minimum number of randomized subjects a country must have before a box plot of time to randomization is included.
panel	character string. Name of panel, which goes into file base names and figure labels for cross-referencing.
h	numeric. Height of ordinary plots, in inches.
w	numeric. Width of ordinary plots.
hb	numeric. Height of extended box plots.
wb	numeric. Weight of extended box plots.
hdot	numeric. Height of dot charts in inches.

Details

Typically the left-hand-side variables of the formula, in order, are date of enrollment and date of randomization, with subjects enrolled but not randomized having missing date of randomization. Given such date variables, this function generates cumulative frequencies optionally with target enrollment/randomization numbers and with time-zooming. Makes a variety of dot charts by right-hand-side variables: number of subjects, number of sites, number of subjects per site, fraction of enrolled subjects randomized, number per month, number per site-month.

Examples

## Not run: 
# See test.Rnw in tests directory

## End(Not run)

harrelfe/greport documentation built on Sept. 9, 2023, 8:08 a.m.