rates: AAPOR Survey Response Rates

Description Usage Arguments Details Value References See Also Examples

View source: R/dispatch.R

Description

Calculate AAPOR response, cooperation, refusal, and contact rates.

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
rates(x, ...)

## S3 method for class 'factor'
rates(x, ...)

## S3 method for class 'character'
rates(x, w = NULL, e = 1, ...)

## S3 method for class 'table'
rates(x, ...)

## S3 method for class 'list'
rates(x, e = 1, ...)

Arguments

x

A character or factor vector containing unit-specific disposition codes, or a named table or list summarizing the disposition codes.

w

Optionally, if x is a vector of disposition codes, the weights to be applied to each case in calculating final, weighted disposition counts.

e

Optionally, the (estimated) proportion of units of unknown eligibility (uh anduo) that are eligible. Otherwise assumed to be 1 (all eligible).

...

Additional arguments passed to methods.

Details

This function calculates all response, cooperation, refusal, and contact rates based upon the disposition code information supplied in x. The allowed disposition codes are “i”, “p”, “r”, “nc”, “o”, “uh”, and “uo”. Both upper and lower case are allowed. e is assumed to be 1 unless specified otherwise. Smith (2009) provides a review of estimation of e. One possible calculation of e suggested by the Standard Definition's calculator is the number of eligible e = \frac{i + p + r + nc + o}{i + p + r + nc + o + uo}. The default used here, however, is the more conservative value of 1.

Value

A list of class “aapor_rates” containing the calculated response rates. Printing of the results is handled by a method that accepts a fmt argument in the form required by sprintf.

References

AAPOR. 2016. “Standard Definitions Final Dispositions of Case Codes and Outcome Rates for Surveys.” Smith, Tom W. 2009. “A Revised Review of Methods to Estimate the Status of Cases with Unknown Eligibility.” NORC/University of Chicago.

See Also

See rr1, ref1, coop1, con1 for calculation of each rate.

Examples

1
2
3
4
5
6
7
8
9
# `x` is a character vector of codes
rates(c(rep("I", 100), rep("NC", 20)))
rates(c(rep("I", 100), rep("NC", 20)), w = runif(120))

# `x` is a list/table of code counts
rates(list(i = 100, nc = 20))

# specifying `e`
rates(list(i = 100, nc = 20, uo = 100, e = .25))

leeper/responserates documentation built on May 21, 2019, 12:38 a.m.