Skip to main content

GIDDY: GeospatIal Distribution DYnamics

Project description

GeospatIal Distribution DYnamics (giddy) in PySAL

Build Status Coverage Status Gitter room Documentation Status PyPI version DOI

Giddy is an open-source python library for the analysis of dynamics of longitudinal spatial data. Originating from the spatial dynamics module in PySAL (Python Spatial Analysis Library), it is under active development for the inclusion of newly proposed analytics that consider the role of space in the evolution of distributions over time.

Below are six choropleth maps of US state per-capita incomes from 1929 to 2004 at a fifteen-year interval.



Online documentation is available here.


  • Directional LISA, inference and visualization as rose diagram


Above shows the rose diagram (directional LISAs) for US states incomes across 1969-2009 conditional on relative incomes in 1969.

  • Spatially explicit Markov methods:
    • Spatial Markov and inference
    • LISA Markov and inference
  • Spatial decomposition of exchange mobility measure (rank methods):
    • Global indicator of mobility association (GIMA) and inference
    • Inter- and intra-regional decomposition of mobility association and inference
    • Local indicator of mobility association (LIMA)
      • Neighbor set LIMA and inference
      • Neighborhood set LIMA and inference


  • Income mobility measures



Install the stable version released on the Python Package Index from the command line:

pip install giddy

Install the development version on pysal/giddy:

pip install


  • libpysal
  • esda
  • mapclassify


PySAL-giddy is under active development and contributors are welcome.

If you have any suggestion, feature request, or bug report, please open a new issue on GitHub. To submit patches, please follow the PySAL development guidelines and open a pull request. Once your changes get merged, you’ll automatically be added to the Contributors List.


If you are having issues, please talk to us in the gitter room.


The project is licensed under the BSD license.

BibTeX Citation

  author       = {Wei Kang and
                  Sergio Rey and
                  Philip Stephens and
                  Nicholas Malizia and
                  Levi John Wolf and
                  Stefanie Lumnitz and
                  jlaura and
                  Charles Schmidt and
                  eli knaap and
                  James Gaboardi and
                  Andy Eschbacher},
  title        = {pysal/giddy: giddy 2.1.0},
  month        = apr,
  year         = 2019,
  doi          = {10.5281/zenodo.2633309},
  url          = {}


Award #1421935 New Approaches to Spatial Distribution Dynamics

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

giddy-2.2.0.tar.gz (48.2 kB view hashes)

Uploaded source

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