Installation

Installing dependencies

splot is compatible with Python 3.8+ and depends on GeoPandas 0.9.0 or later and matplotlib 3.3.3 or later. Please make sure that you are operating in a Python 3 environment.

splot also uses

  • numpy

  • seaborn

  • mapclassify

  • Ipywidgets

Depending on your spatial analysis workflow and the PySAL objects you would like to visualize, splot relies on:

PySAL >=2.0

or the installation of separate packages found in the PySAL stack:

  • esda

  • libpysal

  • spreg

  • giddy

Installing the newest release

There are two ways of accessing splot. First, splot is installed with the PySAL 2.0 metapackage through:

`$ pip install -U pysal`

or

`$ conda install -c conda-forge pysal`

Second, splot can be installed as a separate package. If you are using Anaconda, install splot via the conda utility:

`$ conda install -c conda-forge splot`

Otherwise, you can install splot from PyPI with pip:

`$ pip install splot`

Troubleshooting

Most common installation errors are due to splot’s dependency on GeoPandas.

It often helps to first install GeoPandas separately from conda-forge with:

`$ conda install --channel conda-forge geopandas`

before installing splot (preferably also from conda, alternatively from pip).

For more information on troubleshooting the installation of GeoPandas with pip, see the GeoPandas docuemntation.

It is also possible to install splot with a later Python version (>3.8) through the separate installation of GeoPandas or through installation with conda-forge.

Installing the development version

Potentially, you might want to use the newest features in the development version of splot on github - pysal/splot while have not been incorporated in the Pypi released version. You can achieve that by installing pysal/splot by running the following from a command shell:

pip install git+https://github.com/pysal/splot.git

You can also fork the pysal/splot repo and create a local clone of your fork. By making changes to your local clone and submitting a pull request to pysal/splot, you can contribute to the splot development.