ci.pvaf {MBESS}

Confidence Interval for the Proportion of Variance Accounted for (in the dependent variable by knowing the levels of the factor)

Description

Function to obtain the exact confidence limits for the proportion of variance of the dependent variable accounted for by knowing the levels of the factor (or the grouping factor in a single factor design) group status in a fixed factor analysis of variance.

Usage

ci.pvaf(F.value = NULL, df.1 = NULL, df.2 = NULL, N = NULL, 
conf.level = 0.95, alpha.lower = NULL, alpha.upper = NULL, ...)

Arguments

F.value

observed F-value from fixed effects analysis of variance

df.1

numerator degrees of freedom

df.2

denominator degrees of freedom

N

sample size

conf.level

confidence interval coverage (i.e., 1-Type I error rate); default is .95

alpha.lower

Type I error for the lower confidence limit

alpha.upper

Type I error for the upper confidence limit

...

allows one to potentially include parameter values for inner functions

Details

The confidence level must be specified in one of following two ways: using confidence interval coverage (conf.level), or lower and upper confidence limits (alpha.lower and alpha.upper).

This function uses the confidence interval transformation principle (Steiger, 2004) to transform the confidence limits for the noncentrality parameter to the confidence limits for the population proportion of variance accounted for by knowing the group status. The confidence interval for the noncentral F parameter can be obtained from the function conf.limits.ncf in MBESS, which is used within this function.

Value

Returns the confidence interval for the proportion of variance of the dependent variable accounted for by knowing group status in a fixed factor analysis of variance (using a noncentral F-distribution).

Lower.Limit.Proportion.of.Variance.Accounted.for

The lower confidence limit for the proportion of variance accounted for in the deviation by group status.

Upper.Limit.Proportion.of.Variance.Accounted.for

The upper confidence limit for the proportion of variance accounted for in the deviation by group status.

Note

This function can be used for single or factorial ANOVA designs.

Author(s)

Ken Kelley (University of Notre Dame; [e-mail])

References

Fleishman, A. I. (1980). Confidence intervals for correlation ratios. Educational and Psychological Measurement, 40, 659–670.

Kelley, K. (2007). Constructing confidence intervals for standardized effect sizes: Theory, application, and implementation. Journal of Statistical Software, 20 (8), 1–24.

Steiger, J. H. (2004). Beyond the F Test: Effect size confidence intervals and tests of close fit in the Analysis of Variance and Contrast Analysis. Psychological Methods, 9, 164–182.

See Also

conf.limits.ncf

Examples

## Not run: 
## Bargman (1970) gave an example in which a 5-group ANOVA with 11 subjects in each 
## group is conducted and the observed F value is 11.2213. This example was used 
## in Venables (1975),  Fleishman (1980), and Steiger (2004). If one wants to calculate the 
## exact confidence interval for the proportion of variance accounted for in that example, 
## this function can be used.

ci.pvaf(F.value=11.221, df.1=4, df.2=50, N=55)

ci.pvaf(F.value=11.221, df.1=4, df.2=50, N=55, conf.level=.90)

ci.pvaf(F.value=11.221, df.1=4, df.2=50, N=55,  alpha.lower=0, alpha.upper=.05)

## End(Not run)