parse_dose_finding_outcomes: Parse a string of dose-finding trial outcomes.
Description
Parse a string of dose-finding trial outcomes
Parse a string of dose-finding trial outcomes to a list.
The outcome string describes the doses given, outcomes observed and the
timing of analyses that recommend a dose. The format of the string is
the pure phase I analogue to that described in Brock _et al_. (2017).
The letters T and N are used to represents patients that experienced
(T)oxicity and (N)o toxicity. These letters are concatenated after numerical
dose-levels to convey the outcomes of cohorts of patients.
For instance, 2NNT represents a cohort of three patients that were
treated at dose-level 2, one of whom experienced toxicity, and two that did
not. The results of cohorts are separated by spaces and it is assumed that a
dose-finding decision takes place at the end of a cohort. Thus,
2NNT 1NN builds on our previous example, where the next cohort of two
were treated at dose-level 1 and neither of these patients experienced
toxicity. See examples.
Usage
parse_dose_finding_outcomes(outcome_string)
Value
a list with a slot for each cohort. Each cohort slot is itself a
list, containing elements:
* dose, the integer dose delivered to the cohort;
* outcomes, a character string representing the T or N
outcomes for the patients in this cohort.
Arguments
outcome_string
character representing doses given, outcomes
observed, and timing of analyses. See Description.
References
Brock, K., Billingham, L., Copland, M., Siddique, S., Sirovica, M., & Yap, C.
(2017). Implementing the EffTox dose-finding design in the Matchpoint trial.
BMC Medical Research Methodology, 17(1), 112.
https://doi.org/10.1186/s12874-017-0381-x