# Introduction to spatial data analysis with geopandas¶

We will use geopandas 1 as our main tool for spatial data analysis in Python. In the first part of this book, we covered the basics of data analysis using the pandas library. Geopandas extends the capacities of pandas with geospatial operations.

The main data structures in geopandas are GeoSeries and GeoDataFrame which extend the capabilities of Series and DataFrames from pandas. This means that we can use all our pandas skills also when working with geopandas.

The main difference between geopandas GeoDataFrames and pandas DataFrames is that a GeoDataFrame should contain one column for geometries. By default, the name of this column is 'geometry'. The geometry column is a GeoSeries which contains the geometries (points, lines, polygons, multipolygons etc.) as shapely objects.

Figure 6.X. Geometry column in a GeoDataFrame.

Similar to importing import pandas as pd, we will import geopandas as gpd:

import geopandas as gpd


## Input data: Finnish topographic database¶

In this lesson we will work with the National Land Survey of Finland (NLS) topographic database 2.

In this lesson, we will focus on terrain objects(Feature group: “Terrain/1” in the topographic database). The Terrain/1 feature group contains several feature classes. Our aim in this lesson is to save all the Terrain/1 feature classes into separate files.

Terrain/1 features in the Topographic Database:

feature class

Name of feature

Feature group

32421

Motor traffic area

Terrain/1

32200

Cemetery

Terrain/1

34300

Sand

Terrain/1

34100

Rock - area

Terrain/1

34700

Rocky area

Terrain/1

32500

Quarry

Terrain/1

32112

Mineral resources extraction area, fine-grained material

Terrain/1

32111

Mineral resources extraction area, coarse-grained material

Terrain/1

32611

Field

Terrain/1

32612

Garden

Terrain/1

32800

Terrain/1

32900

Park

Terrain/1

35300

Paludified land

Terrain/1

35412

Bog, easy to traverse forested

Terrain/1

35411

Open bog, easy to traverse treeless

Terrain/1

35421

Open fen, difficult to traverse treeless

Terrain/1

33000

Earth fill

Terrain/1

33100

Sports and recreation area

Terrain/1

36200

Lake water

Terrain/1

36313

Watercourse area

Terrain/1

According to the naming convention 4, all files that start with a letter m and end with p contain the objects we are interested in (Terrain/1 polygons).

You can use wget program (available in Binder and CSC Notebooks) to download the data from the command line from this download link: https://github.com/AutoGIS/data/raw/master/L2_data.zip. Let’s download the data into the same folder with the lesson 2 notebooks (.../notebooks/L2):

1. Open up a new terminal window

2. Navigate to the correct folder in the terminal:

# Navigate to lesson 2 notebooks directory:
cd autogis/notebooks/L2


1. Use wget to dowload the data from the dowload link:

wget https://github.com/AutoGIS/data/raw/master/L2_data.zip



Copy-paste

You can paste copied text in JupyterLab Terminal by pressing SHIFT + RIGHT-CLICK on your mouse and choosing Paste.

Once you have downloaded the L2_data.zip file into your (cloud) computer, you can unzip the file using unzip command in the Terminal (or e.g. 7zip on Windows if working with own computer). Run the following commands in the .../notebooks/L2 -directory:

$unzip L2_data.zip$ ls L2_data



You can also check the contents of the downloaded and unzipped file in the file browser window.

The L2_data folder contains several subfolders according to the file strucutre in the topographic database shapefile distribution. After unzipping the downloaded file, you can find the data for this tutorial under: L2_data/NLS/2018/L4/L41/L4132R.shp. Notice that Shapefile -fileformat contains many separate files such as .dbf that contains the attribute information, and .prj -file that contains information about coordinate reference system.

## Managing filepaths¶

Built-in module os provides many useful functions for interacting with the operating system. One of the most useful submodules in the os package is the os.path-module for manipulating file paths. This week, we have data in different sub-folders and we can practice how to use os path tools when defining filepaths.

Let’s import os and see how we can construct a filepath by joining a folder path and file name:

import os

# Define path to folder
input_folder = r"L2_data/NLS/2018/L4/L41/L4132R.shp"

# Join folder path and filename
fp = os.path.join(input_folder, "m_L4132R_p.shp")

# Print out the full file path
print(fp)


Esri Shapefile is the default file format when reading in data usign geopandas, so we only need to pass the file path in order to read in our data:

import geopandas as gpd

# Read file using gpd.read_file()


Let’s check the data type:

type(data)


Here we see that our data -variable is a GeoDataFrame. GeoDataFrame extends the functionalities of pandas.DataFrame in a way that it is possible to handle spatial data using similar approaches and datastructures as in pandas (hence the name geopandas).

Let’s check the first rows of data:

data.head()

• Check all column names:

data.columns.values


As you might guess, the column names are in Finnish. Let’s select only the useful columns and rename them into English:

data = data[["RYHMA", "LUOKKA", "geometry"]]


Define new column names in a dictionary:

colnames = {"RYHMA": "GROUP", "LUOKKA": "CLASS"}


Rename:

data.rename(columns=colnames, inplace=True)


Check the output:

data.head()


Figure out the following information from our input data using your pandas skills:

• Number of rows?

• Number of classes?

• Number of groups?

print("Number of rows", len(data["CLASS"]))
print("Number of classes", data["CLASS"].nunique())
print("Number of groups", data["GROUP"].nunique())


It is always a good idea to explore your data also on a map. Creating a simple map from a GeoDataFrame is really easy: you can use .plot() -function from geopandas that creates a map based on the geometries of the data. Geopandas actually uses matplotlib for plotting which we introduced in Lesson 7 of the Geo-Python course.

Let’s try it out, and plot our GeoDataFrame:

data.plot()


Voilá! As we can see, it is really easy to produce a map out of your Shapefile with geopandas. Geopandas automatically positions your map in a way that it covers the whole extent of your data.

If you are living in the Helsinki region, you might recognize the shapes plotted on the map!

## Geometries in geopandas¶

Geopandas takes advantage of Shapely’s geometric objects. Geometries are stored in a column called geometry that is a default column name for storing geometric information in geopandas.

Let’s print the first 5 rows of the column ‘geometry’:

data["geometry"].head()


As we can see the geometry column contains familiar looking values, namely Shapely Polygon -objects. Since the spatial data is stored as Shapely objects, it is possible to use Shapely methods when dealing with geometries in geopandas.

Let’s have a closer look at the polygons and try to apply some of the Shapely methods we are already familiar with.

Let’s start by checking the area of the first polygon in the data:

# Access the geometry on the first row of data
data.at[0, "geometry"]

# Print information about the area
print("Area:", round(data.at[0, "geometry"].area, 0), "square meters")


Let’s do the same for the first five rows in the data;

• Iterate over the GeoDataFrame rows using the iterrows() -function that we learned during the Lesson 6 of the Geo-Python course.

• For each row, print the area of the polygon (here, we’ll limit the for-loop to a selection of the first five rows):

# Iterate over rows and print the area of a Polygon
for index, row in data[0:5].iterrows():

# Get the area from the shapely-object stored in the geometry-column
poly_area = row["geometry"].area

# Print info
print(
"Polygon area at index {index} is: {area:.0f} square meters".format(
index=index, area=poly_area
)
)


As you see from here, all pandas methods, such as the iterrows() function, are directly available in Geopandas without the need to call pandas separately because Geopandas is an extension for pandas.

In practice, it is not necessary to use the iterrows()-approach to calculate the area for all features. Geodataframes and geoseries have an attribute area which we can use for accessing the area for each feature at once:

data.area


Let’s next create a new column into our GeoDataFrame where we calculate and store the areas of individual polygons:

# Create a new column called 'area'
data["area"] = data.area


Check the output:

data["area"]


These values correspond to the ones we saw in previous step when iterating rows.

Let’s check what is the min, max and mean of those areas using familiar functions from our previous Pandas lessions.

# Maximum area
round(data["area"].max(), 2)

# Minimum area
round(data["area"].min(), 2)

# Average area
round(data["area"].mean(), 2)


## Writing data into a file¶

It is possible to export GeoDataFrames into various data formats using the to_file() method. In our case, we want to export subsets of the data into Shapefiles (one file for each feature class).

Let’s first select one class (class number 36200, “Lake water”) from the data as a new GeoDataFrame:

# Select a class
selection = data.loc[data["CLASS"] == 36200]


Check the selection:

selection.plot()

• write this layer into a new Shapefile using the gpd.to_file() -function:

# Create a output path for the data
output_folder = r"L2_data/"
output_fp = os.path.join(output_folder, "Class_36200.shp")

# Write those rows into a new file (the default output file format is Shapefile)
selection.to_file(output_fp)


Read the output Shapefile in a new geodataframe, and check that the data looks ok.

temp = gpd.read_file(output_fp)

# Check first rows

# You can also plot the data for a visual check
temp.plot()


## Grouping the GeoDataFrame¶

Next we will automate the file export task. we will group the data based on column CLASS and export a shapefile for each class.

This can be achieved using the groupby() familiar from the pandas library and also available in GeoDataFrames. This function groups data based on values on selected column(s).

Before continuing, let’s check the first rows of our input data:

data.head()


The CLASS column in the data contains information about different land use types. With .unique() -function we can quickly see all different values in that column:

# Print all unique values in the column
data["CLASS"].unique()


Now we can use that information to group our data and save all land use types into different layers:

# Group the data by class
grouped = data.groupby("CLASS")

# Let's see what we have
grouped


As we can see, groupby -function gives us an object called DataFrameGroupBy which is similar to list of keys and values (in a dictionary) that we can iterate over.

Check group keys:

grouped.groups.keys()


The group keys are unique values from the column by which we grouped the dataframe.

Check how many rows of data each group has:

# Iterate over the grouped object
for key, group in grouped:

# Let's check how many rows each group has:
print("Terrain class:", key)
print("Number of rows:", len(group), "\n")


There are, for example, 56 lake polygons in the input data.

We can also check how the last group looks like (we have the variables in memory from the last iteration of the for-loop):

group.head()


Notice that the index numbers refer to the row numbers in the original data -GeoDataFrame.

Check also the data type of the group:

type(group)


As we can see, each set of data are now grouped into separate GeoDataFrames, and we can save them into separate files.

### Saving multiple output files¶

Let’s export each class into a separate Shapefile. While doing this, we also want to create unique filenames for each class.

When looping over the grouped object, information about the class is stored in the variable key, and we can use this information for creating new variable names inside the for-loop. For example, we want to name the shapefile containing lake polygons as “terrain_36200.shp”.

String formatting

There are different approaches for formatting strings in Python. Here are a couple of different ways for putting together file-path names using two variables:

basename = "terrain"
key = 36200

# OPTION 1. Concatenating using the + operator:
out_fp = basename + "_" + str(key) + ".shp"

# OPTION 2. Positional formatting using % operator
out_fp = "%s_%s.shp" %(basename, key)

# OPTION 3. Positional formatting using .format()
out_fp = "{}_{}.shp".format(basename, key)


Let’s now export terrain classes into separate Shapefiles.

• First, create a new folder for the outputs:

# Determine output directory
output_folder = r"L2_data/"

# Create a new folder called 'Results'
result_folder = os.path.join(output_folder, "Results")

# Check if the folder exists already
if not os.path.exists(result_folder):

print("Creating a folder for the results..")
# If it does not exist, create one
os.makedirs(result_folder)

else:


At this point, you can go to the file browser and check that the new folder was created successfully.

• Iterate over groups, create a file name, and save group to file:

# Iterate over the groups
for key, group in grouped:
# Format the filename
output_name = "terrain_{}.shp".format(key)

# Print information about the process
print("Saving file", os.path.basename(output_name))

# Create an output path
outpath = os.path.join(result_folder, output_name)

# Export the data
group.to_file(outpath)


Excellent! Now we have saved those individual classes into separate Shapefiles and named the file according to the class name. These kind of grouping operations can be really handy when dealing with layers of spatial data. Doing similar process manually would be really laborious and error-prone.

### Save attributes to a text file¶

We can also extract basic statistics from our geodataframe, and save this information as a text file.

Let’s summarize the total area of each group:

area_info = grouped.area.sum().round()

area_info


Save area info to csv using pandas:

# Create an output path