patientSummary: Summarise patient exposure by dose

In PuzzledFace/crmReporter: Utility Functions for the Design and Reporting of CRM Trials

Description

Summarise patient exposure by dose

Usage

patientSummary(
  data,
  dose = Dose,
  tox = Toxicity,
  toxLabels = NA,
  doseGrid = NULL
)

Arguments

data	the mcmc tibble to be summarised
dose	the name of the column in data which defines the dose
tox	the name of the column in data which defines the toxicity status. See Usage notes below.
toxLabels	the names of the variables tahat will contain the incidence counts in the output dataset. See Usage notes below.
doseGrid	the values of dose for which incidence counts will be included in the output dataset. See Usage notes below.

Value

a tibble containing one row for each value in doseGrid and columns named: the value of dose, Treated, Evaluable, and one for each element in doseGrid. See Usage notes below.

Usage notes

tox should take integer values from 0 to N, with 0 indicating no toxicity and values of 1 or more indicating increasing values of toxicity. If toxLabels is NA, default labelds are created dependent on the number of distinct values of tox found in data. If there are one or two, labels are "None" and "DLT". If there are exactly three, labels are "None", "SubDLT" and "DLT". If there are four or more, labels are "None, "Cat1", ..., "CatN". doseGrid can be used to ensure that all relevant doses appear in the output dataset, even those with observed zero counts. In the output dataset, Treated counts the number of observations with non-missing values of dose; Evaluable counts the number of observations with non-missing tox; None counts the number of observations wuth tox equal to 1, and the other count variables count the number of observations with eachand one for each of the remaining values of tox.

Examples

data("oQuigleyPatientData")
patientSummary(oQuigleyPatientData, doseGrid=1:6)

PuzzledFace/crmReporter documentation built on June 21, 2020, 12:52 a.m.