plot.pipe: Plot escalation or operating characteristics for trials...

In pipe.design: Dual-Agent Dose Escalation for Phase I Trials using the PIPE Design

Description

Plot method for a trial or series of trials conducted using a pipe.design model.

Usage

## S3 method for class 'pipe'
plot(x, type = "b", pi = x$pi, theta = x$theta, epsilon.line = TRUE, 
    uppertox.constraint.line = FALSE, add.empirical.data = FALSE, ...)
## S3 method for class 'pipe.sim'
plot(x, pi = x$pi, theta = x$theta, plot = "both", ...) 

Arguments

x	An object of class "pipe" or "pipe.sim" as returned by pipe.design
type	The type of information to be plotted for a single PIPE trial. Options are "r" (number of outcomes only), "n" (number of patients only), or "b" (both number of outcomes and patients). The default is to plot both the number of outcomes and patients for each dose combination, by using symbols and colour filling, respectively.
pi	A matrix with rows denoting levels of drug A and columns denoting levels of drug B. Each element gives the true probability of the outcome (dose-limiting toxicity) for that dose combination. If omitted then the true probabilities of the outcome will be taken from that used when creating the x object.
theta	The target toxicity probability. If omitted then theta is taken from that used when creating the x object.
epsilon.line	Should the toxicity safety contour specified by epsilon in pipe.design be shown? Defaults to TRUE.
uppertox.constraint.line	Should the toxicity safety contour specified by uppertox.constraint in pipe.design be shown? Defaults to FALSE.
add.empirical.data	Should an extra plot be produced with the empirical posterior median toxicity probabilities (from the independent beta distributions), and 95
plot	The type of operating characteristics to plot for a series of simulated PIPE trials. Options are "exp" (experimentation percentages), "rec" (recommendation percentages), or "both" (both experimentation and recommendation percentages side-by-side). The default is "both".
...	Further arguments passed to or from other methods

Details

If a single trial is conducted, then the plot function currently produces a series of matrix plots by cohort showing the cumulative outcome and sample size information for each dose combination. Also shown as a solid black line is the most likely MTC before outcomes from each cohort are observed and, if specified, one or more toxicity safety contours shown in red. The final cohort shows the most likely MTC at the end of the trial together with the true MTC (green dashed line) and the recommended Phase II doses (blue squares), which are always doses below the most likely MTC that have been experimented on (see Mander and Sweeting, Statistics in Medicine 2015 for more details).

If multiple PIPE trials have been simulated then experimentation and recommendation percentages are shown as a heat plot over the dose space together with the true MTC (green dashed line).

Author(s)

Michael Sweeting [e-mail]

References

Mander A.P., Sweeting M.J. A product of independent beta probabilities dose escalation design for dual-agent phase I trials. Statistics in Medicine (2015) 34(8): 1261–1276.

See Also

pipe.design, print.pipe

pipe.design documentation built on May 2, 2019, 12:39 a.m.