Creating Beautiful Geospatial Data Visualisations with Python

Presented by Dr. Adam Symington (PythonMaps)

This repository contains all the material needed by students registered for the "Creating Beautiful Geospatial Data Visualisations with Python" tutorial at SciPy 2022 on 12th July 2022.

For a smooth experience, you will need to make sure that you install or update your Python distribution and download the tutorial material before the day of the tutorial. Furthermore, there are a number of data sources (listed below) required for the tutorial. These will need to be downloaded and placed in the resources folder ahead of time.

This workshop will consist of four hands on tutorials / examples.

Visualising Points and Lines

The first part of this task will involve reading, manipulating, and plotting point data and the second will involve the creation linestrings from points. There will be a brief introduction on the task at hand and a run through of the tutorial as well as a brief discussion around the finer points of data visualisation.

Attendees will use the world port index to generate a map showing the locations of the world’s ports.
In the second half, attendees will use the locations of the world’s airports and data on the number of flights between each airport to generate a series of linestrings representing flightpaths and plot this data to show the worlds flight paths.

Learning Outcomes

Understand how to read and manipulate point/line data as well as generate points and lines from latitude and longitude values.
Understand how to plot point data with Matplotlib.
Understand how to generate linestrings from points using Shapely.
Understand how to plot line data with GeoPandas.
Understand how to reproject shape data using GeoPandas and Cartopy.

Visualising Polygons

Following a brief introduction, attendees will be tasked with creating visualisations using polygons and multipolygons. Attendees will use the Natural Earth dataset to generate different visualisations depending on which polygons take their fancy. An example will be provided showing how to overlay the worlds time zones onto a standard world map.

Learning outcomes:

Understand how to read and manipulate polygon and multipolygon data as well as generate polygons and multipolygons from latitude and longitude values.
Understand how plot polygons and multipolygons using GeoPandas.
Understand how to reproject polygons and multipolygons using GeoPandas and Cartopy.

Visualising Rasters

There will be a short introduction and then attendees will be tasked with creating visualisations using raster files. There are several open-source raster datasets available through NEO (NASA earth observations) and attendees will be encouraged to use whichever dataset takes their fancy. An example will be provided and discussed outlining how to plot the world’s population density.

Learning outcomes:

Understand how to read and manipulate raster data with Rasterio and rioxarray.
Understand how to plot raster data with Rasterio and Matplotlib
Understand how to reproject raster data with rioxarray.

Combing shapes with rasters

This section will outline how to overlay shape data like lines or polygons onto raster data like satellite imagery and how to use polygons to isolate specific parts of a raster. For example, use a polygon representing the borders of a country to isolate the data for that country in the raster image.

Learning Outcomes:

Understanding how to use geospatial reference systems to ensure that the shape data is overlaid on the raster data in the correct location.
Understanding how to use rioxarray to clip a raster according to the outline of a polygon.

Download Tutorial Materials

This GitHub repository is all that is needed in terms of tutorial content. The simplest solution is to download the material using this link:

https://github.com/symmy596/PythonMaps-Scipy-2022/archive/refs/heads/master.zip

If you are familiar with Git, you can also clone this repository with:

$ git clone https://github.com/symmy596/PythonMaps-Scipy-2022.git

It will create a new folder named PythonMaps-Scipy-2022 with all the content you will need.

There are a number of datasets required for these tutorials. These will need to all be downloaded prior to the tutorial and placed in the resources folder.

Tutorial 1 Points and Lines

Tutorial 2 Polygons

Natural Earth

Tutorial 3 Rasters

Tutorial 4 Rasters and Shapes

Install Packages

To be able to run the examples, demos and exercises, you must have the following packages installed:

The following libraries are required to run the workshop

geopandas==0.10.2
pandas==1.4.2
numpy==1.21.5
shapely==1.8.0
matplotlib==3.5.1
cartopy==0.20.2
rasterio==1.2.10
rioxarray==0.11.1

If you are using Anaconda, you can use the Anaconda Prompt (Windows) or Terminal.app (macOS) to create an environment with the necessary packages:

Open the Anaconda Prompt or Terminal.app using the below instructions:
- Windows: Click Start and search for "Anaconda Prompt". Click on the application to launch a new Anaconda Prompt window.
- macOS: Open Spotlight Search (using Cmd+Space) and type "Terminal.app". Click on the application to launch a new Terminal.app window.

Create a new Anaconda virtual environment by executing the below command in the application window you opened in step 1 above.

conda create -n pythonmaps-tutorial jupyter geopandas==0.10.2 pandas==1.4.2 numpy==1.21.5 shapely==1.8.0 matplotlib==3.5.1 cartopy==0.20.2 rasterio==1.2.10 rioxarray==0.11.1

To test your installation, please execute the check_env.py script in the environment where you have installed the requirements. If you created an Anaconda environment using the instructions above, keep the application window that you opened in step 1 active (or launch the platform specific application again -- Anaconda Prompt for Windows or Terminal.app for macOS), navigate to where you have this GitHub repository, and type:
```
$ conda activate pythonmaps-tutorial
$ python check_env.py
```

You should see a window pop up with a plot that looks vaguely like a smiley face.