MESS (version 0.5.12)

power_binom_test: Power Calculations for Exact Test of a simple null hypothesis in a Bernoulli experiment

Description

Compute power of test, or determine parameters to obtain target power.

Usage

power_binom_test(
  n = NULL,
  p0 = NULL,
  pa = NULL,
  sig.level = 0.05,
  power = NULL,
  alternative = c("two.sided", "less", "greater")
)

Value

Object of class power.htest, a list of the arguments (including the computed one) augmented with method and note elements.

Arguments

n

Number of observations

p0

Probability under the null

pa

Probability under the alternative

sig.level

Significance level (Type I error probability)

power

Power of test (1 minus Type II error probability)

alternative

One- or two-sided test

Author

Claus Ekstrom

Details

The procedure uses uniroot to find the root of a discontinuous function so some errors may pop up due to the given setup that causes the root-finding procedure to fail. Also, since exact binomial tests are used we have discontinuities in the function that we use to find the root of but despite this the function is usually quite stable.

See Also

binom.test

Examples

power_binom_test(n = 50, p0 = .50, pa = .75)      ## => power = 0.971
power_binom_test(p0 = .50, pa = .75, power = .90) ## =>     n = 41
power_binom_test(n = 50, p0 = .25, power = .90, alternative="less")  ## => pa = 0.0954