superiorityAnalysis: Superiority Analysis Across Interventions for CRT, MST, or...

In epts: Educational Platform Trials Simulator

Superiority Analysis Across Interventions for CRT, MST, or SRT Designs

Description

This function performs a Bayesian superiority analysis, comparing each intervention against a reference intervention, across cluster randomized trials (CRT), multisite trials (MST) or simple randomized trials (SRT).

Usage

superiorityAnalysis(
  method = c("crt", "mst", "srt"),
  data,
  outcome = "posttest",
  interventions = "interventions",
  Random = "schools",
  Nsim = 10000,
  Threshold = 0.05,
  refintervention = 1,
  SupThreshold = 0.8,
  continuous_covariates = NULL,
  categorical_covariates = NULL
)

Arguments

method	The trial design type: "crt", "mst", or "srt".
data	A data frame containing the variables including outcome, predictors, the clustering variable, and the intervention.
outcome	The name of the outcome (post-test) variable.
interventions	A string specifying the intervention variable.
Random	The name of the clustering variable (e.g., schools or sites) for CRT and MST designs.
Nsim	Number of MCMC iterations to be performed. A minimum of 10,000 is recommended to ensure convergence.
Threshold	The effect size threshold for posterior computation (default = 0.05).
refintervention	The value of the intervention used as the reference group (default = 1).
SupThreshold	The minimum posterior probability threshold to declare superiority (default = 0.8).
continuous_covariates	A character vector specifying the names of continuous covariates.
categorical_covariates	A character vector specifying the names of categorical covariates (converted to factors).

Details

The effect size is estimated against a reference intervention, which by default is intervention 1 but can be reassigned to any other intervention, including the control (refintervention = 0).

Value

A data.frame with columns:

• Intervention: Intervention group identifier.

• ProbES: Posterior probability of superiority over the reference intervention.

• Superiority: Label indicating "Superior", "Not Superior", or "Reference".

See Also

crtBayes, mstBayes, srtBayes functions from the eefAnalytics package

Examples

###Superiority analysis of cluster randomized trial###
data(crt4armSimData)
superiorityAnalysis(method = "crt", data = crt4armSimData, outcome = "posttest",
interventions = "interventions", Random = "schools", Nsim = 10000, refintervention = 2,
Threshold = 0.05, SupThreshold = 0.8,continuous_covariates = c("pretest"),
categorical_covariates = c("gender", "ethnicity"))

###Superiority analysis of multisite trial###
data(mst4armSimData)
superiorityAnalysis(method = "mst", data = mst4armSimData, outcome = "posttest",
interventions = "interventions", Random = "schools", Nsim = 10000, refintervention = 2,
Threshold = 0.05, SupThreshold = 0.8,continuous_covariates = c("pretest"),
categorical_covariates = c("gender", "ethnicity"))

###Superiority analysis of simple randomized trial###
data(srt4armSimData)
superiorityAnalysis(method = "srt", data = srt4armSimData, outcome = "posttest",
interventions = "interventions", Nsim = 10000, refintervention = 2,
Threshold = 0.05, SupThreshold = 0.8,continuous_covariates = c("pretest"),
categorical_covariates = c("gender", "ethnicity"))

epts documentation built on June 8, 2025, 11:04 a.m.