CARM:Covariate-adjusted Adaptive Randomization via Mahalanobis-distance

Description

The CARM package provides function of implement of randomization:

ARM functions

please ?ARM and ?ARMM to view function usage

Adaptive Randomization via Mahalanobis Distance

Description

Allocates patients to one of two treatments using Adaptive Randomization via Mahalanobis Distance proposed by Yichen Qin,Yang Li, Wei Ma, Haoyu Yang, and Feifang Hu.(2022)

Usage

ARM(covariate, assignment, q = 0.75)

Arguments

Details

Suppose that n patients are to be assigned to two treatment groups. Consider p continuous covariates for each patient. T_i is the assignment of the ith patient. The proposed procedure to assign units to treatment groups, namely adaptive randomization via Mahalanobis distance (ARM), is outlined below.

(1) Arrange all n units randomly into a sequence x_1,...,x_n.

(2) Assign the first two units with T_1=1 and T_2=2.

(3) Suppose that 2i units have been assigned to treatment groups, for the 2i+1-th and 2i+2-th units:

(3a) If the 2i+1-th unit is assigned to treatment 1 and the 2i+2-th unit to treatment 2, then calculate the potential Mahalanobis distance, between the updated treatment groups. with 2i+2 units, M_1(2i + 2).

(3b) Similarly, if the 2i+1-th unit is assigned to treatment 2 and the 2i+2-th unit to treatment 1, then calculate the other potential Mahalanobis distance, M_2(2i + 2).

(4) Assign the 2i+1-th unit to treatment groups according to the following probabilities:

if M_1(2i + 2) < M_2(2i + 2), P(T_{2i+1} = 1)= q;

if M_1(2i + 2) > M_2(2i + 2), P(T_{2i+1} = 1)= 1-q;

if M_1(2i + 2) = M_2(2i + 2), P(T_{2i+1} = 1)= 0.5.

(5) Repeat the last two steps until all units are assigned. If n is odd, assign the last unit to two treatments with equal probabilities.

Mahalanobis distance M(n) between the sample means across different treatment groups is:

M(n)= np(1-p)(\hat{x_1} - \hat{x_2})^Tcov(x)^{-1}(\hat{x_1} - \hat{x_2}

See the reference for more details.

Value

An object of class "ARM" is a list containing the following components:

References

Qin, Y., Y. Li, W. Ma, H. Yang, and F. Hu (2022). Adaptive randomization via mahalanobis distance. Statistica Sinica.DOI:<10.5705/ss.202020.0440>.

Examples

library(MASS)
#simulate covariates of patients
p <- 6; n <- 30
sigma <- diag(p); mean <- c(rep(0,p))
data <- mvrnorm(n, mean, sigma)
covariate <- as.data.frame(data)
#IF all the patients are not be allocated
ARM(covariate = covariate, assignment = NA, q=0.75)
#IF you had allocated partial patients
ARM(covariate = covariate,assignment = c(1,2),q=0.75)

Adaptive Randomization via Mahalanobis distance for Multi-arm design

Description

Randomize patients into treatment groups for multi-arm trials using ARMM proposed by Haoyu Yang, Yichen Qin, Yang Li, Fan Wang, and Feifang Hu.(2022)

Usage

ARMM(covariate, assignment, K, q = 0.75, method)

Arguments

Details

Suppose n units (participants) are to be assigned to K treatment groups. For each unit i, i = 1, ..., n and treatment j, j = 1, ..., K, define the assignment matrix [T_{ij}]^{n*K}, where T_{ij}=1 indicates unit i receives treatment j. Consider p continuous covariates, let x_i = (x_{i1},...,x_{in})^T.

The proposed method, namely the adaptive randomization via Mahalanobis distance for multi-arm design (ARMM), is outlined below. The implement of ARMM is similar to ARM.

First assume that n units are in a sequence and then assign the first K units to K treatment groups randomly as the initialization. Then, the following units are assigned in blocks of K sequentially and adaptively until all the units are assigned. For K units are assigned to K groups, there are in total K! possible allocations. Calculate K! potential overall covariate imbalance measurement according to pairwise Mahalanobis distance under the K! possible allocations. Choose the allocation which corresponds to the smallest Mahalanobis distance with a probability of q across all potential allocations. Repeat the process until all units are assigned.

For any pair of treatments s and t among the K treatment groups, calculate the Mahalanobis distance by:

M_{s,t}(n) = 2n/K/K(\hat{x}_1 -\hat{x}_2)^Tcov(x)^{-1}(\hat{x}_1 -\hat{x}_2)

In total, there are C_K^2 pairs of Mahalanobis distances among K treatment groups.Finally, calculate the mean, the median or the maximum to represent the total imbalance.

See the reference for more details.

Value

An object of class "ARMM" is a list containing the following components:

References

Yang H, Qin Y, Wang F, et al. Balancing covariates in multi-arm trials via adaptive randomization. Computational Statistics & Data Analysis, 2023, 179: 107642. https://doi.org/10.1016/j.csda.2022.107642

Examples

library(MASS)
#simulate covariates of patients
p <- 6; n <- 30
sigma <- diag(p); mean <- c(rep(0,p))
data <- mvrnorm(n, mean, sigma)
covariate <- as.data.frame(data)
#IF all the patients are not be allocated
ARMM(covariate = covariate, assignment = NA, K = 3, q = 0.75, method = 'mean')
#IF you had allocated partial patients
ARMM(covariate = covariate, assignment = c(1,2), K=4, q=0.75, method = 'max')