View source: R/groupRAR_functions.R

Group.dyldDBCD_Bin | R Documentation |

Simulating group doubly biased coin deisgn with delayed discrete response (number of arms `\ge 2`

) in a clinical trial context. (Inference: two-sided hypothesis testing t-test or chi-square test)

```
Group.dyldDBCD_Bin(n0 = 20, p, k, ssn, gsize.param,
rspT.dist, rspT.param, theta0 = NULL,
target.alloc = "RPW", r = 2, nsim = 2000,
eTime = 7, mRate = NULL, alpha = 0.05)
```

`n0` |
A positive integer. |

`p` |
A positive vector of length equals to |

`k` |
A positive integer. The value specifies the number of treatment groups involved in a clinical trial. ( |

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

`gsize.param` |
A positive integer. It represents the expected number of people enrolling in a specified interval, assuming that the enrollment rate per unit time follows a Poisson distribution. |

`rspT.dist` |
Distribution Type. Specifies the type of distribution that models the time spent for the availability of patient |

`rspT.param` |
A vector with length |

`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 |

`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. |

`eTime` |
A positive number. The interval time between enrollment of participants in each group. The default is 7. |

`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 |

`alpha` |
a numerical value 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. |

Hu and Zhang's Doubly Biased Coin Design (DBCD) adjusts the probability of assigning each patient to a specific treatment group in a clinical trial, based on the responses of all previous patients. The Group DBCD is an enhanced version of this approach, offering a more practical perspective. It dynamically updates the allocation probabilities for patients in each group based on the avaiable responses of all preceding groups, either when the data available or at fixed time intervals (weekly or biweekly). Here, the function focuses on implementing the group doubly biased coin design, tailored to delayed binary responses.

The process begins by assigning `n0`

(perhaps the first few groups of) 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 esmatied desired allocation proportion is calculated. Afterward, the Hu and Zhang's allocation function is applied to determine the probabilities for the next group of patients to be assigned to each treatment group, which force the allocation proportion close to the desired one. This process is repeated sequentially for each group until the desired number of patients has been allocated, as predetermined.

This methodology was introduced by Zhai, Li, Zhang and Hu in their 2023 paper titled 'Group Response-Adaptive Randomization with Delayed and Missing Responses'.

`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. |

Zhai, G., Li, Y., Zhang, L. X. & Hu, F. (2023). *Group Response-Adaptive Randomization with Delayed and Missing Responses.*

```
# a simple use
# Define the arguments
## Arguments for generate the simulated data
### For response simulation
p = c(0.7, 0.5)
k = 2
ssn = 200
### for enter time and response time simulation
eTime = 7
rspT.param = rep(10, 4)
rspT.dist = "exponential"
gsize.param = 5
## Arguments for the deisgn
n0 = 10
target.alloc = "RPW"
res = Group.dyldDBCD_Bin(n0, p, k, ssn, gsize.param,
rspT.dist, rspT.param, theta0 = NULL,
target.alloc = "RPW", r = 2,
nsim = 120, eTime = 7, mRate = NULL, alpha = 0.05)
# View the output (A list of all results)
res
```

Embedding an R snippet on your website

Add the following code to your website.

For more information on customizing the embed code, read Embedding Snippets.