Gesopatial data can be managed and plotted using Geopandas – a geospatial extension to Pandas. This comes with some basic basemap data, but you will probably want to add your own basemap data. For our basemap, we shall use the built-in World basemap and add Oklahoma County Subdivision boundaries to it.
For these examples, you will need to install numpy, matplotlib, pandas, and geopandas. All can be installed using pip.
First we create a World basemap using geopandas’ own low resolution World map:
import numpy as np import matplotlib.pyplot as plt import pandas as pd import geopandas as gpd # Basic Earth Plot path = gpd.datasets.get_path('naturalearth_lowres') df = gpd.read_file(path) fig, ax = plt.subplots() df.plot(ax=ax) plt.show()
“naturalearth_lowres” is a basemap provided with geopandas. We create a set of axes (ax) using the call to subplots(). Although unnecessary for the above example, it allows us to plot multiple layers on the same map (ie. same set of axes). Here is the resulting map:
This uses a standard matplotlib frame. You can use this to zoom and pan around the map.
Next we will add the Oklahoma County Subdivisions. This can be downloaded from catalog.data.gov in the form of ESRI Shape files. Here is the amended code:
# Basic Earth Plot path = gpd.datasets.get_path('naturalearth_lowres') df = gpd.read_file(path) # Load the OK County data okcounty = gpd.read_file('okdata/tl_2016_40_cousub.shp') print(okcounty.head()) fig, ax = plt.subplots() # World base plot df.plot(ax=ax) # OK County layer: black boundary shapes, no fill okcounty.geometry.boundary.plot(color=None, edgecolor='k', linewidth=0.5, ax=ax) plt.show()
Here is the result:
We see the sub-divisions after zooming in on Oklahoma:
Next we shall add the data that we wish to validate. The Oklahoma well injection data has a row for each well. Two columns provide the location. We shall attempt to plot each well with a red dot on the above map.
We do this by importing the data into a pandas DataFrame, and then creating a geopandas GeoDataFrame from this:
xl = pd.ExcelFile("UIC injection volumes 2017.xlsx") well_data = xl.parse("Sheet1") # Create a GeoDataFrame well_gdf = gpd.GeoDataFrame(well_data, geometry=gpd.points_from_xy(well_data['Long_X'], well_data['Lat_Y'])) well_gdf.plot(ax=ax, marker='+', color='red', markersize=2) plt.show()
Here is the resulting map:
Where is the map? If you look closely, there are a few red dots. Also the axes are wrong – the numbers are far too big. What has happened is that a few of the coordinates are either in a different coordinate system (not decimal longitude,latitude), or some of them have incorrect or missing decimal points. We could check the data points and possibly correct them. For now, we will simply filter all data points outside of the valid range of longitude (-180…180) and latitude (-90…90). We perform this within the pandas DataFrame using calls to between():
xl = pd.ExcelFile("UIC injection volumes 2017.xlsx") well_data = xl.parse("Sheet1") print(well_data.head()) # Filter - out of range coords filt_wells = well_data[ well_data['Long_X'].between(-180.0, 180.0) ] filt_wells = filt_wells[ filt_wells['Lat_Y'].between(-90.0, 90.0) ] # Create a GeoDataFrame well_gdf = gpd.GeoDataFrame(filt_wells, geometry=gpd.points_from_xy(filt_wells['Long_X'], filt_wells['Lat_Y'])) well_gdf.plot(ax=ax, marker='+', color='red', markersize=2) plt.show()
Here is the resulting World map:
That is much better! We can also see some red around the black of Oklahoma. However there are some other red clusters that are no where near Oklahoma. There’s a cluster near Africa at 0,0 – a common location for data with missing coordinates. Similarly, there are clusters where the latitude is zero (on the Equator, due south of Oklahoma) and longitude is zero (on the Meridian, due east of Oklahoma).
Finally, there’s a large cluster in China. This happens to have the same longitude and latitude as Oklahoma, but in the eastern hemisphere. The western hemisphere is indicated with negative longitude, whilst the eastern is indicated with positive longitude. Clearly these coordinates are missing a negative sign. This is easy to correct, using numpy to correct the longitude values in situ:
# Correct the positive longitudes (using numpy) filt_wells['Long_X'] = np.where(filt_wells.Long_X > 0.0, - filt_wells.Long_X, filt_wells.Long_X)
We cannot recover the missing coordinate values for the other erroneous points, so we will filter them out. A bounding rectangle filter is applied:
# Filter to the Oklahoma area (+~0.5 degrees border) filt_wells = filt_wells[ filt_wells['Long_X'].between(-103.5, -95.0) ] filt_wells = filt_wells[ filt_wells['Lat_Y'].between(33.0, 37.5) ]
This much tighter filter means the original filter to valid world coordinates is superfluous and can now be removed. However, we need to apply this new filter after correcting the erroneous longitude signs.
Here is the resulting world map:
And here is the Oklahoma detail:
There are a small number of data points in Texas. The next step would be to investigate these. It is likely their coordinates have been mis-typed.
This is the last in a series of articles showing you how to load data into Python, and then validate it. Data validation can be at the field level using functional checks, as well as at the dataset level using visual inspection.