powerRiskRatioExactEquiv: Power for Exact Unconditional Test of Equivalence in Risk...

View source: R/RcppExports.R

powerRiskRatioExactEquivR Documentation

Power for Exact Unconditional Test of Equivalence in Risk Ratio

Description

Obtains the power given sample size for exact unconditional test of equivalence in risk ratio.

Usage

powerRiskRatioExactEquiv(
  n = NA_integer_,
  riskRatioLower = NA_real_,
  riskRatioUpper = NA_real_,
  pi1 = NA_real_,
  pi2 = NA_real_,
  allocationRatioPlanned = 1,
  alpha = 0.05,
  calculateAttainedAlpha = 1L
)

Arguments

n

The total sample size.

riskRatioLower

The lower equivalence limit of risk ratio.

riskRatioUpper

The upper equivalence limit of risk ratio.

pi1

The assumed probability for the active treatment group.

pi2

The assumed probability for the control group.

allocationRatioPlanned

Allocation ratio for the active treatment versus control. Defaults to 1 for equal randomization.

alpha

The significance level for each of the two one-sided tests. Defaults to 0.05.

calculateAttainedAlpha

Whether to calculate the attained alpha.

Value

A data frame with the following variables:

  • alpha: The specified significance level for each of the two one-sided tests.

  • attainedAlphaH10: The attained significance level under H10 if requested.

  • attainedAlphaH20: The attained significance level under H20 if requested.

  • power: The power.

  • n: The sample size.

  • riskRatioLower: The lower equivalence limit of risk ratio.

  • riskRatioUpper: The upper equivalence limit of risk ratio.

  • pi1: The assumed probability for the active treatment group.

  • pi2: The assumed probability for the control group.

  • riskRatio: The risk ratio.

  • allocationRatioPlanned: Allocation ratio for the active treatment versus control.

  • zstatRiskRatioLower: The efficacy boundaries on the z-test statistic scale for the one-sided null hypothesis on the lower equivalence limit.

  • zstatRiskRatioUpper: The efficacy boundaries on the z-test statistic scale for the one-sided null hypothesis on the upper equivalence limit.

Author(s)

Kaifeng Lu, kaifenglu@gmail.com

Examples


powerRiskRatioExactEquiv(
  n = 200, riskRatioLower = 0.8, riskRatioUpper = 1.25,
  pi1 = 0.775, pi2 = 0.775, alpha = 0.05)


lrstat documentation built on Oct. 18, 2024, 9:06 a.m.