View source: R/generic.lp.test.R
| power.lp.test | R Documentation |
Determines the power, the non-centrality parameter, or the degrees of freedom for the lambda-prime distribution with (optional) Type 1 and Type 2 error plots.
power.lp.test(
power = NULL,
ncp = NULL,
req.sign = "+",
null.ncp = 0,
df = NULL,
alpha = 0.05,
alternative = c("two.sided", "one.sided", "two.one.sided"),
plot = TRUE,
verbose = 1,
utf = FALSE
)
power |
statistical power |
ncp |
non-centrality parameter for the alternative; either
|
req.sign |
whether |
null.ncp |
non-centrality parameter for the null. When alternative =
"two.one.sided", the function expects two values in the
form |
df |
degrees of freedom; either |
alpha |
type 1 error rate, defined as the probability of
incorrectly rejecting a true null hypothesis, denoted as
|
alternative |
character; the direction or type of the hypothesis test: "two.sided", "one.sided", or "two.one.sided". "two.one.sided" is used for equivalence and minimal effect testing. |
plot |
logical; |
verbose |
|
utf |
logical; whether the output should show Unicode
characters (if encoding allows for it). |
power |
statistical power |
ncp |
non-centrality parameter under alternative. |
null.ncp |
non-centrality parameter under null. |
df |
degrees of freedom. |
alpha |
type 1 error rate (user-specified). |
alternative |
the direction or type of the hypothesis test. |
t.alpha |
critical value(s). |
beta |
type 2 error rate. |
type.s |
type S error rate (only for two-tailed test). |
type.m |
type M error rate (only for two-tailed test). |
# two-sided
# power defined as the probability of observing test statistics greater
# than the positive critical value OR less than the negative critical value
power.lp.test(ncp = 1.960, df = 100, alpha = 0.05,
alternative = "two.sided", plot = FALSE)
power.lp.test(power = 0.800, df = 100, alpha = 0.05,
alternative = "two.sided", plot = FALSE)
# the two examples below estimate the df's based upon the first example
# (revealing a power of 0.498; df = 94.11) and the second example (revealing
# a ncp of 2.825; df = 101.06)
power.lp.test(ncp = 1.960, power = 0.498, alpha = 0.05,
alternative = "two.sided", plot = FALSE)
power.lp.test(ncp = 2.825, power = 0.800, alpha = 0.05,
alternative = "two.sided", plot = FALSE)
# one-sided
# power is defined as the probability of observing a test statistic greater
# than the critical value
power.lp.test(ncp = 1.960, df = 100, alpha = 0.05, alternative = "one.sided")
power.lp.test(power = 0.800, df = 100, alpha = 0.05, alternative = "one.sided")
# the two examples below estimate the df's based upon the first example
# (revealing a power of 0.6207; df = 100.323) and the second example (revealing
# a ncp of 2.506; df = 99.12)
power.lp.test(ncp = 1.960, power = 0.6207, alpha = 0.05,
alternative = "one.sided", plot = FALSE)
power.lp.test(ncp = 2.506, power = 0.8000, alpha = 0.05,
alternative = "one.sided", plot = FALSE)
# equivalence
# power is defined as the probability of observing a test statistic greater
# than the upper critical value (for the lower bound) AND less than the
# lower critical value (for the upper bound)
power.lp.test(ncp = 0, null.ncp = c(-3, 3), df = 100, alpha = 0.05,
alternative = "two.one.sided", plot = FALSE)
power.lp.test(power = 0.80, req.sign = "0", null.ncp = c(-3, 3),
df = 100, alpha = 0.05, alternative = "two.one.sided", plot = FALSE)
# adjust the power based upon what is returned from the example above in
# order to get a valid estimate of the df's (100.321; power = 0.8 -> 58.911)
power.lp.test(ncp = 0, power = 0.8103, req.sign = "0", null.ncp = c(-3, 3),
alpha = 0.05, alternative = "two.one.sided", plot = FALSE)
# minimal effect testing
# power is defined as the probability of observing a test statistic greater
# than the upper critical value (for the upper bound) OR less than the lower
# critical value (for the lower bound).
power.lp.test(ncp = 2, null.ncp = c(-1, 1), df = 100, alpha = 0.05,
alternative = "two.one.sided", plot = FALSE)
power.lp.test(power = 0.80, req.sign = "+", null.ncp = c(-1, 1),
df = 100, alpha = 0.05, alternative = "two.one.sided")
# the first example (ncp = 2) reveals insufficient power (0.169), hence
# use the ncp returned from the example above for estimating the df's
power.lp.test(ncp = 3.844, power = 0.8, req.sign = "+", null.ncp = c(-3, 3),
alpha = 0.05, alternative = "two.one.sided", plot = FALSE)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.