test_par_dom.Rd
Simulates a parallel-group design and performs equivalence testing using the difference of means (DOM) approach. This function evaluates whether the treatment and reference groups are equivalent based on predefined equivalence margins and hypothesis testing criteria.
test_par_dom(
n,
muT,
muR,
SigmaT,
SigmaR,
lequi_tol,
uequi_tol,
alpha,
dropout,
typey,
adseq,
k,
arm_seedT,
arm_seedR,
TART,
TARR,
vareq
)
integer number of subjects per arm
vector mean of endpoints on treatment arm
vector mean of endpoints on reference arm
matrix covar-variance matrix on treatment arm across endpoints
matrix covar-variance matrix on reference arm across endpoints
vector lower equivalence tolerance band across endpoints
vector upper equivalence tolerance band across endpoints
vector alpha value across endpoints
vector of size 2 with dropout proportion per arm (T,R)
vector with positions of primary endpoints
boolean is used a sequential adjustment?
integer minimum number of equivalent endpoints
integer seed for the simulation on treatment arm
integer seed for the simulation on reference arm
double treatment allocation rate for the treatment arm
double treatment allocation rate for the reference arm
boolean assumed equivalence variance between arms for the t-test
A numeric matrix containing the simulated hypothesis test results. The first column represents the overall equivalence decision, where 1 indicates success and 0 indicates failure. The subsequent columns contain the hypothesis test results for each endpoint, followed by mean estimates for the reference and treatment groups, and standard deviations for the reference and treatment groups.
The function simulates a parallel-group study design and evaluates equivalence
using the difference of means (DOM) approach. It accounts for dropout rates and
treatment allocation proportions while generating simulated data based on the
specified covariance structure. The test statistics are computed, and a final
equivalence decision is made based on the predefined number of required significant
endpoints (k
). If sequential testing (adseq
) is enabled, primary endpoints
must establish equivalence before secondary endpoints are evaluated.
When vareq = TRUE
, the test assumes equal variances between groups and
applies Schuirmann's two one-sided tests (TOST).