geopandas choropleth examples

Author: nicolaskruchten

Diff for: binder/requirements.txt

@@ -18,3 +18,4 @@ cufflinks==0.17.3
 kaleido
 scikit-learn
 umap-learn
+wget

Diff for: doc/python/choropleth-maps.md

@@ -6,7 +6,7 @@ jupyter:
       extension: .md
       format_name: markdown
       format_version: '1.2'
-      jupytext_version: 1.3.1
+      jupytext_version: 1.4.2
   kernelspec:
     display_name: Python 3
     language: python
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.6.8
+    version: 3.7.7
   plotly:
     description: How to make choropleth maps in Python with Plotly.
     display_as: maps
@@ -164,7 +164,29 @@ fig.update_layout(margin={"r":0,"t":0,"l":0,"b":0})
 fig.show()
 ```
 
-<!-- #region -->
+### Using GeoPandas Data Frames
+
+`px.choropleth` accepts the `geometry` of a GeoPandas data frame as the input to `geojson`.
+
+```python
+import plotly.express as px
+import geopandas as gpd
+import wget
+
+# download and load a zipped shapefile into a GeoDataFrame
+wget.download("https://plotly.github.io/datasets/nyc_boroughs.zip")
+geo_df = gpd.read_file("zip://nyc_boroughs.zip")
+
+
+fig = px.choropleth(geo_df, 
+                   geojson=geo_df.geometry,
+                   locations=geo_df.index, 
+                   color='shape_leng',
+                   hover_name="boro_name")
+fig.update_geos(fitbounds="locations", visible=False)
+fig.show()
+```
+
 
 ### Using Built-in Country and State Geometries
 
@@ -179,7 +201,6 @@ Plotly comes with two built-in geometries which do not require an external GeoJS
 
 To use the built-in countries geometry, provide `locations` as [three-letter ISO country codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3).
 
-<!-- #endregion -->
 
 ```python
 import plotly.express as px

Diff for: doc/python/mapbox-county-choropleth.md

@@ -6,7 +6,7 @@ jupyter:
       extension: .md
       format_name: markdown
       format_version: '1.2'
-      jupytext_version: 1.3.1
+      jupytext_version: 1.4.2
   kernelspec:
     display_name: Python 3
     language: python
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.6.8
+    version: 3.7.7
   plotly:
     description: How to make a Mapbox Choropleth Map of US Counties in Python with
       Plotly.
@@ -139,6 +139,30 @@ fig.update_layout(margin={"r":0,"t":0,"l":0,"b":0})
 fig.show()
 ```
 
+### Using GeoPandas Data Frames
+
+`px.choropleth_mapbox` accepts the `geometry` of a GeoPandas data frame as the input to `geojson`.
+
+```python
+import plotly.express as px
+import geopandas as gpd
+import wget
+
+# download and load a zipped shapefile into a GeoDataFrame
+wget.download("https://plotly.github.io/datasets/nyc_boroughs.zip")
+geo_df = gpd.read_file("zip://nyc_boroughs.zip")
+
+fig = px.choropleth_mapbox(geo_df, 
+                           geojson=geo_df.geometry,
+                           locations=geo_df.index, 
+                           color='shape_leng',
+                           hover_name="boro_name",
+                           center={"lat": 40.71, "lon": -74.00},
+                           mapbox_style="open-street-map",
+                           zoom=8)
+fig.show()
+```
+
 ### Discrete Colors
 
 In addition to [continuous colors](/python/colorscales/), we can [discretely-color](/python/discrete-color/) our choropleth maps by setting `color` to a non-numerical column, like the name of the winner of an election.
@@ -209,4 +233,4 @@ fig.show()
 
 #### Reference
 
-See https://plotly.com/python/reference/choroplethmapbox/ for more information about mapbox and their attribute options.
+See https://plotly.com/python/reference/choroplethmapbox/ for more information about mapbox and their attribute options.

Diff for: doc/requirements.txt

@@ -28,3 +28,4 @@ pyarrow
 cufflinks==0.17.3
 kaleido
 umap-learn
+wget