Sprawl v1.0

lgervasoni · Dec 1, 2017 · 6443c5b · 6443c5b
1 parent 963256d
commit 6443c5b
Show file tree

Hide file tree

Showing 36 changed files with 5,136 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -1,2 +1,65 @@
-# urbansprawl
-Urbansprawl is an open framework for calculating spatial urban sprawl indices using open data
+# Urbansprawl
+
+The urbansprawl project provides an open framework to assess the urban sprawl phenomenon.
+It uses OpenStreetMap data to calculate its sprawling indices, divided in Accessibility, Land use mix, and Dispersion.
+
+
+**For more details, refer to:**
+
+* Gervasoni Luciano, Bosch Martí, Fenet Serge, and Sturm Peter. 2016. "[A framework for evaluating urban land use mix from crowd-sourcing data](https://hal.inria.fr/hal-01396792)." 2nd International Workshop on Big Data for Sustainable Development.
+
+* Gervasoni Luciano, Bosch Martí, Fenet Serge, and Sturm Peter. 2017. "[LUM_OSM: une plateforme pour l'évaluation de la mixité urbaine à partir de données participatives](https://hal.inria.fr/hal-01548341)." GAST Workshop, Conférence Extraction et Gestion de Connaissances (EGC 2017).
+
+* Gervasoni Luciano, Bosch Martí, Fenet Serge, and Sturm Peter. 2017. "[Calculating spatial urban sprawl indices using
+open data](https://hal.inria.fr/hal-01535469)." 15th International Conference on Computers in Urban Planning and Urban Management.
+
+## Dependencies
+
+urbansprawl works with Python 2+3.
+
+- Python dependencies:
+```sh
+osmnx utm scipy statsmodels h5py
+```
+
+* Using anaconda:
+```sh
+conda update -c conda-forge --all
+conda install -c conda-forge osmnx utm scipy statsmodels h5py
+```
+
+## Example
+
+PostGIS-enabled PostgreSQL databases are used in this framework (refer to [OSM2PGSQL tools](https://mapzen.com/data/metro-extracts/)):
+
+Results are depicted for the city of **Grenoble, France**:
+
+- Locations and densities of residential and activity land usages
+
+<img src="examples/images/Grenoble_Activity_points.png" width="550">
+<img src="examples/images/Grenoble_Activity_densities.png" width="550">
+<img src="examples/images/Grenoble_Residential_points.png" width="550">
+<img src="examples/images/Grenoble_Residential_densities.png" width="550">
+
+- Street network
+
+<img src="examples/images/Grenoble.png" width="550">
+
+- Buildings
+
+<img src="examples/images/Grenoble_Buildings.png" width="550">
+
+**Sprawling indices:**
+
+- Land use mix indices
+
+<img src="examples/images/Grenoble_Land_use_mix.png" width="550">
+<img src="examples/images/Grenoble_Bubble_land_use_mix.png" width="550">
+
+- Accessibility indices
+
+<img src="examples/images/Grenoble_Accessibility.png" width="550">
+
+- Dispersion indices
+
+<img src="examples/images/Grenoble_Dispersion.png" width="550">
diff --git a/examples/approximation_evaluation.ipynb b/examples/approximation_evaluation.ipynb
diff --git a/examples/images/Grenoble.png b/examples/images/Grenoble.png
diff --git a/examples/images/Grenoble_Accessibility.png b/examples/images/Grenoble_Accessibility.png
diff --git a/examples/images/Grenoble_Activity_densities.png b/examples/images/Grenoble_Activity_densities.png
diff --git a/examples/images/Grenoble_Activity_points.png b/examples/images/Grenoble_Activity_points.png
diff --git a/examples/images/Grenoble_Bubble_land_use_mix.png b/examples/images/Grenoble_Bubble_land_use_mix.png
diff --git a/examples/images/Grenoble_Buildings.png b/examples/images/Grenoble_Buildings.png
diff --git a/examples/images/Grenoble_Dispersion.png b/examples/images/Grenoble_Dispersion.png
diff --git a/examples/images/Grenoble_Dispersion_scatter_plot.png b/examples/images/Grenoble_Dispersion_scatter_plot.png
diff --git a/examples/images/Grenoble_Land_use_mix.png b/examples/images/Grenoble_Land_use_mix.png
diff --git a/examples/images/Grenoble_Residential_densities.png b/examples/images/Grenoble_Residential_densities.png
diff --git a/examples/images/Grenoble_Residential_points.png b/examples/images/Grenoble_Residential_points.png
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.dbf b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.dbf
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.prj b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.prj
@@ -0,0 +1 @@
+GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORITY["EPSG","7030"]],AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4326"]]
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.shp b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.shp
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.shx b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_point.shx
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.dbf b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.dbf
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.prj b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.prj
@@ -0,0 +1 @@
+GEOGCS["WGS 84",DATUM["WGS_1984",SPHEROID["WGS 84",6378137,298.257223563,AUTHORITY["EPSG","7030"]],AUTHORITY["EPSG","6326"]],PRIMEM["Greenwich",0,AUTHORITY["EPSG","8901"]],UNIT["degree",0.0174532925199433,AUTHORITY["EPSG","9122"]],AUTHORITY["EPSG","4326"]]
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.shp b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.shp
diff --git a/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.shx b/examples/input_data/Zagreb_Croatia/zagreb_croatia_osm_polygon.shx
diff --git a/examples/land_use_mix.ipynb b/examples/land_use_mix.ipynb