ENH: add Streetscape class (#658)

* ENH: add Streetscape class

* backwards compatibility

* fix

* docstrings

* rm xarray typing

* fix the docs

* year

* fix typing

* add Alessandro's description

* add osm example

* add short intro to example notebook

Author: martinfleis

ci/envs/310-latest.yaml

@@ -14,6 +14,8 @@ dependencies:
   - esda
   - tqdm
   - numba
+  - rioxarray
+  - xvec
   # testing
   - codecov
   - pytest

ci/envs/311-latest.yaml

@@ -14,6 +14,8 @@ dependencies:
   - esda
   - tqdm
   - numba
+  - rioxarray
+  - xvec
   # testing
   - codecov
   - pytest

ci/envs/312-latest.yaml

@@ -15,6 +15,8 @@ dependencies:
   - esda
   - tqdm
   - numba
+  - rioxarray
+  - xvec
   # testing
   - codecov
   - pytest

docs/_static/references.bib

@@ -223,4 +223,20 @@ @article{tripathy2020open
   pages     = {2188--2205},
   number    = {8},
   doi       = {10.1177/2399808320967680}
-}
+}
+
+@article{araldi2024multi,
+author = {Araldi, Alessandro and Fusco, Giovanni},
+title = {Multi-Level Street-Based Analysis of the Urban Fabric: Developments for a Nationwide Taxonomy},
+journal = {Geographical Analysis},
+year = {2024},
+volume = {n/a},
+number = {n/a},
+pages = {},
+keywords = {morphotypes, streetscape morphometrics, urban fabric},
+doi = {https://doi.org/10.1111/gean.12416},
+url = {https://onlinelibrary.wiley.com/doi/abs/10.1111/gean.12416},
+eprint = {https://onlinelibrary.wiley.com/doi/pdf/10.1111/gean.12416},
+abstract = {Multiple fabric assessment (MFA) is a computer-aided procedure designed for identifying and characterizing urban fabric types (morphotypes) from a street-based perspective. Nonetheless, the original MFA presents some limitations: it relies on surface-based descriptors, conceived as proxy variables for the pedestrian perspective in urban form analysis, rather than direct sight-based measurements. It also uses building footprint classes as proxies for building types. The spatial statistics on the street network concentrate on patterns of over- and under-represented values, which often results in a limited number of morphotypes. Furthermore, the morphotypes are typically valid only for a specific study area. This article presents the latest methodological advancements in MFA overcoming these four limitations. Its implementation over the eight largest French metropolitan areas successfully distinguishes approximately 20 distinct place-specific morphotypes, which are further aggregated into a comprehensive multi-level nested taxonomy. The new MFA procedure allows a nationwide comparative analysis of contemporary urban forms, laying the groundwork for a comprehensive understanding of morphologically regionalized metropolitan areas. Through detailed algorithmic improvements and nationwide implementation, integrating traditional urban morphology with streetscape analysis, MFA provides insights into the analogies and differences of the urban fabric in contemporary metropolitan areas, enabling interoperability with other domains of urban research.}
+}
+

docs/api.rst

@@ -1,6 +1,8 @@
 .. _api_ref:
 
 .. automodule:: momepy
+   :members:
+   :undoc-members:
 
 .. currentmodule:: momepy
 
@@ -179,6 +181,21 @@ With utilities allowing conversion between networkx objects and GeoPandas object
    gdf_to_nx
    nx_to_gdf
 
+
+Measuring streetscape
+---------------------
+
+Specialised class for the advanced streetscape analysis.
+
+.. autosummary::
+   :toctree: api/
+
+   Streetscape
+   Streetscape.compute_plots
+   Streetscape.compute_slope
+   Streetscape.street_level
+   Streetscape.point_level
+
 Data preprocessing
 ------------------