binomTestEnsemble: Ensemble Confidence Intervals for Binomial Proportions

Description Usage Arguments Details Author(s) Examples

View source: R/binomTestEnsemble.R

Description

Generates lower and upper confidence interval limits for a binomial proportion using an ensemble of confidence intervals.

Usage

1
2
3
4
5
6
7
  binomTestEnsemble(n, x,
                    alpha = 0.05,
                    CP = TRUE,
                    WS = TRUE,
                    JF = TRUE,
                    AC = TRUE,
                    AR = TRUE)

Arguments

n

sample size

x

number of successes

alpha

significance level for confidence interval

CP

logical; if TRUE (default), include Clopper-Pearson confidence interval procedure in the ensemble

WS

logical; if TRUE (default), include Wilson-Score confidence interval procedure in the ensemble

JF

logical; if TRUE (default), include Jeffreys confidence interval procedure in the ensemble

AC

logical; if TRUE (default), include Agresti-Coull confidence interval procedure in the ensemble

AR

logical; if TRUE (default), include Arcsine confidence interval procedure in the ensemble

Details

Generates lower and upper confidence interval limits for a binomial proportions using

When the binomTestEnsemble function is called, it returns a two-element vector in which

To construct an Ensemble confidence interval that attains an actual coverage that is close to the stated coverage, the five constituent confidence interval procedures can be combined. Since these intervals vary in width, the lower limits and the actual coverage of the constituent confidence intervals at the maximum likelihood estimator are calculated. Likewise, the upper limits and the actual coverage of the constituent confidence intervals at the maximum likelihood estimator are calculated. The centroids of the lower and upper constituent confidence intervals for points falling below and above the stated coverage are connected with a line segment. The point of intersection of these line segments and the stated coverage gives the lower and upper bound of the Ensemble confidence interval. Special cases to this approach are given in the case of (a) the actual coverages all fall above or below the stated coverage, and (b) the slope of the line connecting the centroids is infinite.

If only one of the logical arguments is TRUE, the code returns a simple confidence interval of that one procedure.

The Wald confidence interval is omitted because it degenerates in actual coverage for x = 0 and x = n.

Author(s)

Hayeon Park (hpark03@email.wm.edu), Larry Leemis (leemis@math.wm.edu)

Examples

1
2
3
4
  binomTestEnsemble(10, 3)
  binomTestEnsemble(100, 82, CP = FALSE, AR = FALSE)
  binomTestEnsemble(33, 1, CP = FALSE, JF = FALSE, AC = FALSE, AR = FALSE)
  

conf documentation built on Aug. 24, 2020, 5:08 p.m.