README.md

In eiCompare: Compares Different Ecological Inference Methods

eiCompare

eiCompare is an R package built to help practitioners and academics quantify racially polarized voting (RPV) with ease and confidence. It builds on top of several existing packages, augmenting their utility for measuring racially polarized voting in elections. Underlying packages include ei, eiPack, and wru.

eiCompare was built with several types of users in mind:

• Expert witnesses in voting rights litigation who need to accurately quantify vote dilution in an area and present the results convincingly to a judge or jury.
• National voting rights advocacy organizations trying to identify elections across the country where vote dilution might be at play.
• Grassroots organizations looking for data-driven tools to fuel their fight against vote dilution at the local level.
• Academics who study the causes and consequences of vote dilution and racially polarized voting.

News

eiCompare 3.0.4

*Fixed a bug in tests/testthat/test_wru_predict_race_wrapper.R that fails if there isnt internet to access wru repo data

eiCompare 3.0.3

• Added handling of connection errors from wru, to comply with CRAN policy on graceful failure when accessing internet resources that have changed or become unavailable.

eiCompare 3.0.2

Package changes

• Removed geocoding helpers from package. These are mostly trivial to code separately and added extra dependencies to the package. Change instigated by update to previous dependency censusxy.

eiCompare 3.0.1

Minor package changes

• Switched maintainer from Loren Collingwood to Ari Decter-Frain (@aridf)
• Minor changes to functions dependent on wru to ensure compatibility with new version

3.0 Update:

The Voting Rights Team of the 2020 University of Washington Data Science for Social Good Fellowship program worked throughout the summer to develop the latest iteration of the package. Highlights from the update include:

• Functions for geocoding addresses on voter files.
• Improved accuracy of BISG estimation through surname preprocessing.
• Refactored code for ecological inference functions.
• Parallel processing to speed up ecological inference and geocoding.
• New built-in visualizations of EI results and estimation diagnostics.
• Performance analysis tools for comparing different election maps.
• Functions for preprocessing address data, surname data, data for ecological inference.

See here for a full list of new features.

Installation

From CRAN

CRAN submission is currently underway. Check back soon for instructions on installation from CRAN.

From Github (development version)

Install latest development version with:

remotes::install_github('RPVote/eiCompare')

Usage

The name eiCompare highlights the utility of this package for comparing different ecological inference estimates. For instance, the following code compares iterative and RxC estimates of racial voting preferences in a stylized version of the 2018 Georgia gubernatorial election:

library(eiCompare)
data("gwinnett_ei")

iter <- ei_iter(
  data = gwinnett_ei,
  cand_cols = c("kemp", "abrams", "metz"),
  race_cols = c("white", "black", "other"),
  totals_col = "turnout",
  name = "Iterative EI",
)

rxc <- ei_rxc(
  data = gwinnett_ei,
  cand_cols = c("kemp", "abrams", "metz"),
  race_cols = c("white", "black", "other"),
  totals_col = "turnout",
  name = "RxC EI",
)

plot(iter, rxc)

The top panel shows that the majority of white voters voted for Brian Kemp, who won this election. The middle panel shows the estiamted preferences of black voters. The estimates indicate that black voters strongly preferred Stacey Abrams over Brian Kemp.

Please refer to the package vignettes for detailed walkthroughs of how this package facilitates ecological inference. To view these in Rstudio, enter browseVignettes("eiCompare") in the console after installing the package.

Platform dependencies

The following platform dependencies may be required on Ubuntu/Debian based systems: sudo apt install libfftw3-dev fftw-dev

Learn More

• To learn about R programming, see Hands-On Programming with R and R for data science
• To learn more about the role of ecological inference in voting rights, visit the eiCompare website

eiCompare documentation built on Aug. 31, 2023, 5:16 p.m.