toxScores {ProAE}

Re-code PRO-CTCAE text responses, apply a zero-imputation procedures, and construct PRO-CTCAE composite grades.

Description

This function takes in a data frame set with PRO-CTCAE survey text fields/responses and returns a data frame with appropriate numerical re-coding. This function will accept 1 or up to all 124 PRO-CTCAE survey fields. All PRO-CTCAE variable names MUST conform to a pre-specified 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 by an underscore (_)

Usage

toxScores(
  dsn,
  reformat = FALSE,
  impute = FALSE,
  composites = FALSE,
  short_labels = FALSE
)

Arguments

dsn

A data.frame object with PRO-CTCAE data

reformat

Reformat PRO-CTCAE text responses to numeric scores. Defaults to FALSE.

impute

Apply zero-imputation where appropriate. Defaults to FALSE.

composites

Construct composite grade using available PRO-CTCAE variables within dsn. Defaults to FALSE.

short_labels

Add PRO-CTCAE short labels to available PRO-CTCAE variables within returned object

Details

• [EX1] Question 1 of PRO-CTCAE should be: PROCTCAE_1A_SCL

• [EX2] Question 48 of PRO-CTCAE should be: PROCTCAE_48A_SCL, PROCTCAE_48B_SCL, PROCTCAE_48C_SCL

• [EX3]Question 73 of PRO-CTCAE should be: PROCTCAE_73A_IND

This function also constructs PRO-CTCAE composite grades. Composite grade variables for respective PRO-CTCAE item groups are created and named as PROCTCAE_##_COMP.

1. https://healthcaredelivery.cancer.gov/pro-ctcae/pro-ctcae_english.pdf

2. Ethan Basch, et al. Development of a Composite Scoring Algorithm for the National Cancer Institute's Patient-Reported Outcomes version of the Common Terminology Criteria for Adverse Events (PRO-CTCAE). ISOQOL 2019

3. Basch E, et al. Composite Grading Algorithm for the National Cancer Institute’s Patient-Reported Outcomes version of the Common Terminology Criteria for Adverse Events (PRO-CTCAE). Clinical Trials 2020.

Data format should be in 'long' format, where each PRO-CTCAE item is a variable/column.

Value

A data.frame object.

Examples

tox_acute_comp = toxScores(dsn = ProAE::tox_acute, composites = TRUE)