comp_polsby: Calculate Polsby Popper Compactness

View source: R/compactness.R

comp_polsbyR Documentation

Calculate Polsby Popper Compactness

Description

Calculate Polsby Popper Compactness

Usage

comp_polsby(
  plans,
  shp,
  use_Rcpp,
  perim_path,
  perim_df,
  epsg = 3857,
  ncores = 1
)

Arguments

plans

redist_plans object or plans_matrix where each row indicates a district assignment and each column is a plan

shp

redist_map object or tibble with sf geometry column

use_Rcpp

If TRUE (the default for more than 8 plans), precompute boundaries shared by each pair of units and use them to quickly compute the compactness score.

perim_path

path to perimeter tibble saved by prep_perims()

perim_df

tibble of perimeters from prep_perims()

epsg

numeric EPSG code to planarize to. Default is 3857.

ncores

numeric. Number of cores to use. Default is 1.

Value

numeric vector

References

Cox, E. 1927. A Method of Assigning Numerical and Percentage Values to the Degree of Roundness of Sand Grains. Journal of Paleontology, 1(3), 179-183.

Polsby, Daniel D., and Robert D. Popper. 1991. “The Third Criterion: Compactness as a procedural safeguard against partisan gerrymandering.” Yale Law & Policy Review 9 (2): 301–353.

Examples

data(nh)
data(nh_m)
# For a single plan:
comp_polsby(plans = nh$r_2020, shp = nh)

# Or many plans:
comp_polsby(plans = nh_m[, 3:5], shp = nh)


redistmetrics documentation built on April 11, 2022, 5:08 p.m.