DBCD_Bin {grouprar}R Documentation

Hu and Zhang's Doubly Biased Coin Design with Binary Response Type

Description

Simulating Hu and Zhang's doubly biased coin deisgn with binary response (number of arms \ge 2) in a clinical trial context. (Inference: two-sided hypothesis testing t-test or chi-square test)

Usage

DBCD_Bin(n0 = 20, p, k, ssn, theta0 = NULL, target.alloc = "RPW",
         r = 2, nsim = 2000, mRate = NULL, alpha = 0.05)

Arguments

n0

A positive integer. n0 represents the initial patient population assogned through restricted randomization for initial parameter estimation.

p

A positive vector of length equals to k. The values specify the true success rates for the various treatments, and these rates are used to generate data for simulations.

k

A positive integer. The value specifies the number of treatment groups involved in a clinical trial. (k \ge 2)

ssn

A positive integer. The value specifies the total number of participants involved in each round of the simulation.

theta0

A vector of length k. Each value in the vector represents a probability used for adjusting parameter estimates. If the argument is not provided, it defaults to a vector of length k, with all values set to 0.5.

target.alloc

Desired allocation proportion. The option for this argument could be one of "Neyman", "RSIHR", "RPW", "WeisUrn". The default is "RPW".

r

A positive number. Parameter for Hu and Zhang's doubly biased coin design and usually take values 2-4. The default value is 2.

nsim

a positive integer. The value specifies the total number of simulations, with a default value of 2000.

mRate

a numerical value between 0 and 1, inclusive, representing the missing rate for the responses. This parameter pertains to missing-at-random data. The default value is NULL, indicating no missing values by default.

alpha

A number between 0 and 1. The value represents the predetermined level of significance that defines the probability threshold for rejecting the null hypothesis, with a default value of 0.05.

Details

The objective of Hu and Zhang's doubly biased coin design is to allocate patients sequentially while closely approximating the desired allocation proportion, which is a function of certain unknown parameters related to the response variable under each treatment.

The process begins by assigning n0 patients to treatment groups using restricted randomization and collecting their responses. Initial parameter estimates for the response variable are then obtained for each treatment group. Subsequently, based on these parameter estimates, the desired allocation proportion is calculated. Afterward, the Hu and Zhang's allocation function is applied to determine the probabilities for the next patient to be assigned to each treatment group, which force the allocation proportion close to the desired one. This process is repeated sequentially for each patient until the desired number of patients has been allocated, as predetermined.

This methodology was introduced by Hu and Zhang in their 2004 paper titled 'Asymptotic Properties of Doubly Adaptive Biased Coin Designs for Multitreatment Clinical Trials.

Value

name

The name of procedure.

parameter

The true parameters used to do the simulations.

assignment

The randomization sequence.

propotion

Average allocation porpotion for each of treatment groups.

failRate

The proportion of individuals who do not achieve the expected outcome in each simulation, on average.

pwClac

The probability of the study to detect a significant difference or effect if it truly exists.

k

Number of arms involved in the trial.

References

Hu, F., & Zhang, L. X. (2004). Asymptotic properties of doubly adaptive biased coin designs for multi-treatment clinical trials. The Annals of Statistics, 32(1), 268-301.

Examples

DBCD_Bin(n0 = 20, p = c(0.7, 0.8), k = 2, ssn = 300, theta0 = NULL,
         target.alloc = "RPW", r = 2, nsim = 50, mRate = NULL, alpha = 0.05)

[Package grouprar version 0.1.0 Index]