Learn R Programming

corpora (version 0.5)

binom.pval: P-values of the binomial test for frequency counts (corpora)

Description

This function computes the p-value of a binomial test for frequency counts. In the two-sided case, a fast approximation is used that may be inaccurate for small samples.

Usage

binom.pval(k, n, p = 0.5,
           alternative = c("two.sided", "less", "greater"))

Arguments

k

frequency of a type in the corpus (or an integer vector of frequencies)

n

number of tokens in the corpus, i.e. sample size (or an integer vector specifying the sizes of different samples)

p

null hypothesis, giving the assumed proportion of this type in the population (or a vector of proportions for different types and/or different populations)

alternative

a character string specifying the alternative hypothesis; must be one of two.sided (default), less or greater

Value

The p-value of a binomial test applied to the given data (or a vector of p-values).

Details

When alternative is two.sided, a fast approximation of the two-sided p-value is used (multiplying the appropriate single-sided tail probability by two), which may be inaccurate for small samples. Unlike the exact algorithm of binom.test, this implementation can be applied to large frequencies and samples without a serious impact on performance.

See Also

z.score.pval, prop.cint