Package: outcomerate 1.0.1.9000

Rafael Pilliard Hellwig

outcomerate: AAPOR Survey Outcome Rates

Standardized survey outcome rate functions, including the response rate, contact rate, cooperation rate, and refusal rate. These outcome rates allow survey researchers to measure the quality of survey data using definitions published by the American Association of Public Opinion Research (AAPOR). For details on these standards, see AAPOR (2016) <https://www.aapor.org/Standards-Ethics/Standard-Definitions-(1).aspx>.

Authors:Rafael Pilliard Hellwig [aut, cre], Carl Ganz [rev], Neal Richardson [rev]

outcomerate_1.0.1.9000.tar.gz
outcomerate_1.0.1.9000.zip(r-4.5)outcomerate_1.0.1.9000.zip(r-4.4)outcomerate_1.0.1.9000.zip(r-4.3)
outcomerate_1.0.1.9000.tgz(r-4.5-any)outcomerate_1.0.1.9000.tgz(r-4.4-any)outcomerate_1.0.1.9000.tgz(r-4.3-any)
outcomerate_1.0.1.9000.tar.gz(r-4.5-noble)outcomerate_1.0.1.9000.tar.gz(r-4.4-noble)
outcomerate_1.0.1.9000.tgz(r-4.4-emscripten)outcomerate_1.0.1.9000.tgz(r-4.3-emscripten)
outcomerate.pdf |outcomerate.html✨
outcomerate/json (API)
NEWS

# Install 'outcomerate' in R:
install.packages('outcomerate', repos = c('https://ropensci.r-universe.dev', 'https://cloud.r-project.org'))

Reviews:rOpenSci Software Review #213

Bug tracker:https://github.com/ropensci/outcomerate/issues

Pkgdown site:https://docs.ropensci.org

Datasets:

On CRAN:outcomerate-1.0.1(2018-10-06)

Conda:

aapordisposition-codespeer-reviewedstandardssurvey

4.78 score 5 stars 24 scripts 132 downloads 2 exports 2 dependencies

Last updated 4 years agofrom:98c74a8165 (on master). Checks:3 OK, 6 NOTE. Indexed: yes.

TargetResultLatest binary
Doc / VignettesOKMar 14 2025
R-4.5-winNOTEMar 14 2025
R-4.5-macNOTEMar 14 2025
R-4.5-linuxNOTEMar 14 2025
R-4.4-winNOTEMar 14 2025
R-4.4-macNOTEMar 14 2025
R-4.4-linuxNOTEMar 14 2025
R-4.3-winOKMar 14 2025
R-4.3-macOKMar 14 2025

Exports:eligibility_rateoutcomerate

Dependencies:rbibutilsRdpack

Intro to outcomerate

Rafael Pilliard Hellwig

Rendered fromintro-to-outcomerate.Rmdusingknitr::rmarkdownon Mar 14 2025.

Last update: 2020-05-16
Started: 2018-04-28

Citation

To cite the AAPOR standards or this package, please use:

The American Association for Public Opinion Research. 2016. Standard Definitions: Final Dispositions of Case Codes and Outcome Rates for Surveys. 9th edition. AAPOR.

Pilliard Hellwig, Rafael. (2018). outcomerate: AAPOR Survey Outcome Rates. R package version 1.0.1

Corresponding BibTeX entries: 

  @Manual{,
    title = {Standard Definitions: Final Dispositions of Case Codes and
      Outcome Rates for Surveys},
    organization = {The American Association for Public Opinion
      Research (AAPOR)},
    note = {9th edition},
    year = {2016},
    url =
      {https://www.aapor.org/Standards-Ethics/Standard-Definitions-(1).aspx},
  }

  @Misc{,
    title = {outcomerate: AAPOR Survey Outcome Rates (R package)},
    author = {Rafael Pilliard Hellwig},
    note = {v1.0.1},
    year = {2018},
    url = {https://github.com/ropensci/outcomerate},
  }

Readme and manuals

outcomerate

outcomerate is a lightweight R package that implements the standard outcome rates for surveys, as defined in the Standard Definitions of the American Association of Public Opinion Research (AAPOR).

Although the mathematical formulas are straightforward, it can get tedious and repetitive calculating all the rates by hand, especially for sub-groups of your study. The formulas are similar to one another and so it is also dangerously easy to make a clerical mistake. The outcomerate package simplifies the analytically workflow by defining all formulas as a collection of functions.

Installation

Install the package from CRAN:

install.packages("outcomerate")

Alternatively, install the latest development version via github:

#install.packages("devtools")
# devtools::install_github("ropensci/outcomerate")
install.packages("outcomerate", repos = c('https://ropensci.r-universe.dev', 'https://cloud.r-project.org'))

Example

Let’s say you try to survey 12 people. After finishing the fieldwork, you tabulate all your attempts into a table of disposition outcomes:

code disposition n
I Complete interview 4
P Partial interview 2
R Refusal and break-off 1
NC Non-contact 1
O Other 1
UH Unknown if household 1
NE Known ineligible 1
UO Unknown, other 1

Using this table, you may wish to report some of the common survey outcome rates, such as:

  • Response Rate: The proportion of your sample that results in an interview.
  • Cooperation Rate: The proportion of people contacted who participate in your survey.
  • Refusal Rate: The proportion of your sample that refused to participate.
  • Contact Rate: The proportion of sampled cases where you manage to reach the respondent.
  • Location Rate: The proportion of cases (say, in an establishment survey) that you manage to locate.

Most of these rates come under a number of variants, having definitions that are standardized by AAPOR. The outcomerate function lets your calculate these rates seamlessly:

# load package
library(outcomerate)

# set counts per disposition code (needs to be a named vector)
freq <- c(I = 4, P = 2, R = 1, NC = 1, O = 1, UH = 1, UO = 1, NE = 1)

# calculate rates, assuming 90% of unknown cases are elligble
outcomerate(freq, e = eligibility_rate(freq))
#>   RR1   RR2   RR3   RR4   RR5   RR6 COOP1 COOP2 COOP3 COOP4  REF1  REF2  REF3 
#> 0.364 0.545 0.370 0.556 0.444 0.667 0.500 0.750 0.571 0.857 0.091 0.093 0.111 
#>  CON1  CON2  CON3  LOC1  LOC2 
#> 0.727 0.741 0.889 0.818 0.833

Dispositions do not always come in a tabulated format. Survey analysts often work with microdata directly, where each row represents an interview. The outcomerate package allows you to obtain rates using such a format as well:

# define a vector of dispositions
x <- c("I", "P", "I", "UO", "R", "I", "NC", "I", "O", "P", "UH")

# calculate desired rates
outcomerate(x, rate = c("RR2", "CON1"))
#>  RR2 CON1 
#> 0.55 0.73

# obtain a weighted rate
w <- c(rep(1.3, 6), rep(2.5, 5))
outcomerate(x, weight = w, rate = c("RR2", "CON1"))
#>  RR2w CON1w 
#>  0.50  0.69

ropensci_footer