match_numbers

District numbers in simulated plans are by and large random. This
function attempts to renumber the districts across all simulated plans to
match the numbers in a provided plan, using the Hungarian algorithm.

Enables researchers to sample redistricting plans from a pre-specified
target distribution using Sequential Monte Carlo and Markov Chain Monte Carlo
algorithms. The package allows for the implementation of various constraints in
the redistricting process such as geographic compactness and population parity
requirements. Tools for analysis such as computation of various summary statistics
and plotting functionality are also included. The package implements the SMC
algorithm of McCartan and Imai (2023) <doi:10.1214/23-AOAS1763>, the enumeration
algorithm of Fifield, Imai, Kawahara, and Kenny (2020) <doi:10.1080/2330443X.2020.1791773>,
the Flip MCMC algorithm of Fifield, Higgins, Imai and Tarr (2020) <doi:10.1080/10618600.2020.1739532>,
the Merge-split/Recombination algorithms of Carter et al. (2019) <arXiv:1911.01503>
and DeFord et al. (2021) <doi:10.1162/99608f92.eb30390f>, and the Short-burst
optimization algorithm of Cannon et al. (2020) <arXiv:2011.02288>.

Christopher T. Kenny

redist

Simulation Methods for Legislative Redistricting

Cory McCartan

Ben Fifield

Kosuke Imai

Jun Kawahara

Alexander Tarr

Michael Higgins

match_numbers function

<dl><dt>data</dt>
<dd>a <code>redist_plans</code> object.</dd>
<dt>plan</dt>
<dd>a character vector giving the name of the plan to match to (e.g.,
for a reference plan), or an integer vector containing the plan itself.</dd>
<dt>total_pop</dt>
<dd>a vector of population counts. Should not be needed for most
<code>redist_plans</code> objects.</dd>
<dt>col</dt>
<dd>the name of a new column to store the vector of population overlap
with the reference plan: the fraction of the total population who are in
the same district under each plan and the reference plan. Set to
<code>NULL</code> if no column should be created.
renumbering options in any plan.</dd></dl>

Arguments

Renumber districts to match an existing plan — match_numbers

<dl>

<dt>data</dt>
<dd>a <code>redist_plans</code> object.</dd>


<dt>plan</dt>
<dd>a character vector giving the name of the plan to match to (e.g.,
for a reference plan), or an integer vector containing the plan itself.</dd>


<dt>total_pop</dt>
<dd>a vector of population counts. Should not be needed for most
<code>redist_plans</code> objects.</dd>


<dt>col</dt>
<dd>the name of a new column to store the vector of population overlap
with the reference plan: the fraction of the total population who are in
the same district under each plan and the reference plan. Set to
<code>NULL</code> if no column should be created.
renumbering options in any plan.</dd>

</dl>

match_numbers: Renumber districts to match an existing plan

Description

Usage

Value

Arguments

Examples