step: Recursively simulate a '3+3/PC' dose-titration study

In dcnorris/DTAT: Dose Titration Algorithm Tuning: a framework for dose individualization

Description

This function is invoked recursively by de.sim, to simulate a complete 3+3/PC study. For details on the 3+3/PC rules, please see the references below.

Usage

step(de, MTDi, verbose = is.null(sys.call(-1)), n.doses = Inf)

Arguments

de	A data frame describing the events of a dose-titration study underway
MTDi	Vector of MTDi's, indexed by participant id
verbose	Logical: the default provides verbose output (for debugging and instruction) when invoked interactively from the R prompt, but not when invoked 'programmatically' by client code.
n.doses	When specified, prevents escalation to (n+1)th dose

Value

A data frames summarizing the events of a dose-titration study up to a given DLT assessment period, having columns as follows:

• id Integer: participants are numbered in order of enrollment, starting from 1

• period Integer: DLT assessment periods of the study, numbered from 1

• dose Integer: dose level received by id during period

• dlt Logical: did participant id experience a DLT during period?

Author(s)

David C. Norris

References

Norris DC. Precautionary Coherence Unravels Dose Escalation Designs. bioRxiv. December 2017:240846. doi:10.1101/240846. https://www.biorxiv.org/content/early/2017/12/29/240846

See Also

de.sim invokes step to simulate a full study.

dcnorris/DTAT documentation built on May 7, 2019, 10:45 p.m.