Welcome to MAUP’s documentation!

maup is the geospatial toolkit for redistricting data. The package streamlines the basic workflows that arise when working with blocks, precincts, and districts, such as

• Assigning precincts to districts,

• Aggregating block data to precincts,

• Disaggregating data from precincts down to blocks,

• Prorating data when units do not nest neatly, and

• Fixing topological issues, overlaps, and gaps

The project’s priorities are to be efficient by using spatial indices whenever possible and to integrate well with the existing ecosystem around pandas, geopandas and shapely. The package is distributed under the MIT License.

Installation

To install maup from PyPI, run

pip install maup

from the terminal.

Modifiable areal unit problem

The name of this package comes from the modifiable areal unit problem (MAUP): the same spatial data will look different depending on how you divide up the space. Since maup is all about changing the way your data is aggregated and partitioned, we have named it after the MAUP to encourage users to use the toolkit thoughtfully and responsibly.

Tutorials

• Getting started with MAUP
  • Assigning precincts to districts
  • Aggregating block data to precincts
  • Disaggregating data from precincts down to blocks
  • Progress bars
• Prorating data when units do not nest neatly
• Fixing topological issues, overlaps, and gaps
• Example

Working with GerryChain

• Using maup to import a real-life plan in GerryChain
  • Downloading shapefiles
  • Getting the assignment
  • Creating a Partition with the real-life assignment
• What to do about islands and connectivity
  • Figuring out what is going on
  • Strategy 1: Delete the problem components
  • Strategy 2: Connect the components manually
  • Discontiguous plans

Index

• Full Package Reference
  • Adjacencies
  • Assign
  • CRS
  • Indexed Geometries
  • Indices
  • Intersections
  • Normalize
  • Progress Bar
  • Repair
  • Smart Repair