multisite.hte: Power for test of heterogeneity of treatment effect in a...

In powertools: Power and Sample Size Tools

Power for test of heterogeneity of treatment effect in a multisite trial

Description

Calculates power for a test of heterogeneity of the treatment effect in a multisite trial with a continuous outcome variable. In particular, let sigma.u1^2 be the variance of the site-level treatment effects. The test of heterogeneity tests the null hypothesis that sigma.u1^2 = 0 versus the alternative that sigma.u1^2 > 0. Can solve for power, J, or m.

Usage

multisite.hte(
  m = NULL,
  alloc.ratio = 1,
  J = NULL,
  VR = NULL,
  alpha = 0.05,
  power = NULL,
  v = FALSE
)

Arguments

m	The mean number of subjects per site.
alloc.ratio	The allocation ratio of intervention/control subjects per site; defaults to 1.
J	The total number of sites.
VR	The variance ratio (variance of the site-level treatment effects divided by variance of observations within sites) under the alternative.
alpha	The significance level (type 1 error rate); defaults to 0.05.
power	The specified level of power.
v	Either TRUE for verbose output or FALSE (default) to output computed argument only.

Details

See Crespi CM (2025) for details.

Value

A list of the arguments (including the computed power).

Examples

multisite.hte(m = 10, J = 30, VR = 8 / 36)

powertools documentation built on April 4, 2025, 5:02 a.m.