tpitable: Tabular display of Dose Escalation Decisions

In anirban0451/tpidesigns: R-Package to generate Toxicity Probability Interval Dose Escalation Design Results (TPI, mTPI, mTPI - 2)

Description

tpitable gives a table of Dose Escalation Decisions when a certain number of DLT 's are observed in different sample size

Usage

tpitable(nmax, design, pt, e1 = 0.05, e2 = 0.05, eta, w, a1 = NULL,
  b1 = NULL, a2 = NULL, b2 = NULL)

Arguments

nmax	Maximum number of patients to be treated in current level of Dose, must be at least 3
design	Design parameter, tells us which design to use. Options are "tpi", "mtpi", "mmtpi"
pt	Target toxicity proportion to achieve in current Dose Level (Less Toxicity means under- dosing, where as more toxicity means over - dosing)
e1	Amount of variation that can be allowed to the left of the pt value to conclude that target toxicity has been achieved. Default value is 0.05. This means, that if a Posterior Toxicity (DLT) mean takes a value within the range (pt - e1, pt), toxicity for the cohort (of size >= 3) will be achieved.
e2	Amount of variation that can be allowed to the right of the pt value to conclude that target toxicity has been achieved. Default value is 0.05. This means, that if a Posterior Toxicity (DLT) mean takes a value within the range (pt, pt + e2), toxicity for the cohort (of size >= 3) will be achieved.
eta	threshold value to check if the Dose is severely toxic
w	Weight on the first Beta distribution of the mixture Prior
a1	alpha parameter ( > 0) for 1st Beta distribution, must be input properly when w = 0 or 1
b1	beta parameter ( > 0) for 1st Beta distribution, must be input properly properly when w = 0 or 1
a2	alpha parameter ( > 0) for 2nd Beta distribution, will not be used if w = 0 or 1
b2	beta parameter ( > 0) for 2nd Beta distribution, will not be used if w = 0 or 1

Details

In Oncology Trials, often the maximum number of people allowed in the treatment is fixed beforehand, and the Dose Escalation Decision starts from including three patients upto maximum number of patients allowed in the cohort. Hence, the motive of this table is to create a frame which will be useful when a Clinician working on these type of Trials experiences a certain number of DLT 's in the sample, he can straightway look at the table and take Dose Escalation Decisions.It is important to note that, the number of patients in a cohort must be atleast 3, addressed by Continual Reassessment Method

Value

A table containing threshold number of DLT 's for Dose Escalation decisions in different cohort size upto the maximum number of patients allowed for treatment

See Also

https://www.cancer.gov/publications/dictionaries/cancer-terms/def/dose-limiting for the Definition of Dose Limiting Toxicity
decisiontpi to know about Dose Escalation Decision Strategy

Examples

tpitable(nmax = 5, design = "mtpi", pt = 0.3, eta = 0.75, w = 1, a1 = 2, b1 = 3)
tpitable(nmax = 13, design = "mmtpi", pt = 0.4, e1 = 0.06, e2 = 0.04, eta = 0.95,
 w = 0.4, a1 = 4, b1 = 3, a2 = 1, b2 = 1)

anirban0451/tpidesigns documentation built on Dec. 7, 2019, 5:35 p.m.