Skip to main content

A package for plotting choropleth maps

Project description


pypi downloads License:MIT DOI

Geostates is a Python package for quickly plotting choropleth maps of the United States.



To install geostates run: pip install geostates.

Dev roadmap

The current version of geostates only allows for plotting choropleth maps of the United States using a very specific set of shapefiles. In the future, the goal is to add:

  • Ability to plot United States maps with county-level data.
  • Add support for Congressional Districts, Metropolitan Statistical Areas, and Zip Code Areas to individual state plots.
  • Add support for plotting categorical data for United States maps.
  • Add features for plotting political science maps (ie. Electoral College maps, etc.).

How to contribute

You can contribute to the geostates package by installing it and giving it a try. You can also file issues on the issue tracker or submit a pull request if you would like to make any improvements.


  • This package's core functionality relies substantially on the geopandas package.
  • The idea to use inset axes for this package came from Cimbali. A helpful explanation on utilizing segmented colormaps came from JohanC. As mentioned in the comments, the function for discretizing matplotlib colormaps was inspired by an example provided in Jake VanderPlas' Python Data Science Handbook.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

geostates-0.1.2.tar.gz (14.8 MB view hashes)

Uploaded Source

Built Distribution

geostates-0.1.2-py3-none-any.whl (14.8 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page