View source: R/generic.t.test.R
| power.t.test | R Documentation |
Determines the power, the non-centrality parameter, or the degrees of freedom for the generic t-Test with (optional) Type 1 and Type 2 error plots.
power.t.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). |
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.t.test(ncp = 1.96, df = 100, alpha = 0.05, alternative = "two.sided")
power.t.test(power = 0.80, df = 100, alpha = 0.05, alternative = "two.sided")
# one-sided
# power is defined as the probability of observing a test statistic greater
# than the critical value
power.t.test(ncp = 1.96, df = 100, alpha = 0.05, alternative = "one.sided")
power.t.test(power = 0.80, df = 100, alpha = 0.05, alternative = "one.sided")
# 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.t.test(ncp = 0, null.ncp = c(-2, 2), df = 100, alpha = 0.05,
alternative = "two.one.sided")
power.t.test(power = 0.80, req.sign = "0", null.ncp = c(-2, 2),
df = 100, alpha = 0.05, alternative = "two.one.sided")
# 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.t.test(ncp = 2, null.ncp = c(-1, 1), df = 100, alpha = 0.05,
alternative = "two.one.sided")
power.t.test(power = 0.80, req.sign = "+", null.ncp = c(-1, 1),
df = 100, alpha = 0.05, alternative = "two.one.sided")
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.