mTPI2Table: mTPI-2 Decision Table

View source: R/getDesignProportions.R

mTPI2TableR Documentation

mTPI-2 Decision Table

Description

Obtains the decision table for the modified toxicity probability interval-2 (mTPI-2) design.

Usage

mTPI2Table(
  nMax = NA_integer_,
  pT = 0.3,
  epsilon1 = 0.05,
  epsilon2 = 0.05,
  a = 1,
  b = 1,
  pExcessTox = 0.95
)

Arguments

nMax

The maximum number of subjects in a dose cohort.

pT

The target toxicity probability. Defaults to 0.3.

epsilon1

The lower equivalence margin from the target. Defaults to 0.05.

epsilon2

The upper equivalence margin from the target. Defaults to 0.05.

a

The prior toxicity parameter for the beta prior.

b

The prior non-toxicity parameter for the beta prior.

pExcessTox

The threshold for excessive toxicity, i.e., if Prob(p > pT | Data) > pExcessTox, then the current and all higher doses will be excluded and never be used again in the remainder of the trial to avoid any other subjects receiving treatment at those doses. Defaults to 0.95.

Value

An S3 class mTPI2Table object with the following components:

  • settings: The input settings data frame with the following variables:

    • nMax: The maximum number of subjects in a dose cohort.

    • pT: The target toxicity probability.

    • epsilon1: The lower equivalence margin from the target.

    • epsilon2: The upper equivalence margin from the target.

    • a: The prior toxicity parameter for the beta prior.

    • b: The prior non-toxicity parameter for the beta prior.

    • pExcessTox: The threshold for excessive toxicity.

  • subintervals: The subintervals of equal length in the mTPI-2 design. It includes the following variables:

    • lower: The lower bound of the subinterval.

    • upper: The upper bound of the subinterval.

    • decision: The dosing decision for the subinterval.

  • decisionDataFrame: The decision data frame for the mTPI-2 design. It includes the following variables:

    • n: The sample size.

    • y: The number of toxicities.

    • decision: The dosing decision.

  • decisionMatrix: The decision matrix corresponding to the decision data frame.

Author(s)

Kaifeng Lu, kaifenglu@gmail.com

Examples


mTPI2Table(nMax = 18, pT = 0.3, epsilon1 = 0.05, epsilon2 = 0.05)


lrstat documentation built on Oct. 18, 2024, 9:06 a.m.