dose.survfit: Calculate a dose-survival curve from a dose titration study,...

View source: R/dose.survfit.R

dose.survfitR Documentation

Calculate a dose-survival curve from a dose titration study, adding a confidence band

Description

The 'dose-survival curve' is nothing other than an empirical cumulative distribution for MTDi in the sampled population. The term 'survival' is suggested in part by our application of the Kaplan-Meier estimator to interval-censored toxicity information.

Usage

dose.survfit(de, method = "rothman", avoid.degeneracy = TRUE, conf.level = 0.8)

Arguments

de

A dose titration experiment like the data slot of class DE

method

The method to be used by km.ci when calculating CI

avoid.degeneracy

When TRUE, this parameter directs the function to introduce artificial events into the dose titration experiment, to avoid degeneracies at the lower and upper ends of the dose-survival curve.

conf.level

Confidence level for KM confidence band.

Details

TODO: Describe details of degeneracy avoidance, once these have stabilized.

Value

An object of class survfit.

Author(s)

David C. Norris

See Also

dose.survival, km.ci

Examples

CV <- 0.7; mean_mtd <- 1.0
shape <- CV^-2; scale <- mean_mtd/shape
trial <- new("DE", doses=0.25 * 1.4^(0:6),
             MTDi=rgamma(24, shape=shape, scale=scale),
             units="mg")
trial <- titration(trial, periods=10)
sf <- dose.survfit(trial@data)
summary(sf)


DTAT documentation built on May 29, 2024, 7:10 a.m.