The ProAE Package ProAE logo

CRAN_Status_Badge Total Downloads Downloads


library(proae) is a collection of functions to facilitate standardized analysis and graphical procedures when using the National Cancer Institute’s Patient-Reported Outcomes version of the Common Terminology Criteria for Adverse Events (PRO-CTCAE).

To use the functions, data needs to be long (multiple observations per patient (e.g one line per cycle) and one column per PRO-CTCAE item). Additionally, PRO-CTCAE items need to follow specific naming structure. PRO-CTCAE variable names are made up of FOUR components: 1)’PROCTCAE’, 2) number [1,2,3, …, i, …, 80], 3) ’A’, ’B’, or ’C’ component of the i-th PRO-CTCAE field, 4) and ’SCL’ (if severity, interference, or frequency) or ’IND’ (if yes/no variable). Each component must be delimited with an underscore (_).

ProAE::PROCTCAE_table provides a crosswalk/look-up table of expected variable names for associated PRO-CTCAE symptom items.

PRO-CTCAE Reference:

The toxScores() Function

toxScores() is a function that easiliy reformats PRO-CTCAE items that were collected as text responses to numeric, applies zero-imputation procedures, and constructs PRO-CTCAE composite grades. This function accepts 1 or up to all 124 PRO-CTCAE items. This function returns a data frame with the respective numerical re-coding and computations. This function should be used prior to other functions in this package.

Composite grading reference:

The toxFigures Function

toxFigures() is a function that creates publication quality longitudinal bar charts of symptomatic AE profiles. Frequency distributions of PRO-CTCAE scores can be shown over the course of the trial and can be stratified by treatment arm. An R list object is returned with the available PRO-CTCAE items indexed as elements of the list beside a reference table. See toxFigures vignette for more detail about how to customize these figures extensively using function parameters.

The toxTables() Function

toxTables() is a function that will produce PRO-CTCAE tables similar to those typically created for CTCAE data. These tables show arm-level sample size and frequency distributions for PRO-CTCAE items. P-values for statistical comparisons using chi-squared or Fisher’s exact tests can be calculated as well as risk-difference between arms and alpha specified confidence intervals. See the toxTables() vignette for more details about how to use this function.

The toxSummary() Function

toxSummary() is a function that creates patient-level adjusted scores and group-level summary statistics. When requesting patient-level summary measures, the output is a data frame object with one observation per patient and include the id_var and PRO-CTCAE items are replaced with the adjusted score.

summary_measure options are:

The toxAUC() Function

toxAUC() is function that summarizes patient’s symptomatic experience by calculating incremental AUC adjusted for baseline symptoms. Arm-level AUCs can be compared statistically using function parameters. See the toxAUC() vignette for more details about how to use this function.

Other objects

ProAE also includes simulated data of common symptomatic AE profiles such as acute, cumulative, cyclical, and late toxicity at various effect sizes for power or exploratory analysis.