Skip to content

Commit 0bae02b

Browse files
authored
ENH: add Streetscape class (pysal#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
1 parent 01413e9 commit 0bae02b

10 files changed

+3603
-1
lines changed

ci/envs/310-latest.yaml

+2
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ dependencies:
1414
- esda
1515
- tqdm
1616
- numba
17+
- rioxarray
18+
- xvec
1719
# testing
1820
- codecov
1921
- pytest

ci/envs/311-latest.yaml

+2
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ dependencies:
1414
- esda
1515
- tqdm
1616
- numba
17+
- rioxarray
18+
- xvec
1719
# testing
1820
- codecov
1921
- pytest

ci/envs/312-latest.yaml

+2
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@ dependencies:
1515
- esda
1616
- tqdm
1717
- numba
18+
- rioxarray
19+
- xvec
1820
# testing
1921
- codecov
2022
- pytest

docs/_static/references.bib

+17-1
Original file line numberDiff line numberDiff line change
@@ -223,4 +223,20 @@ @article{tripathy2020open
223223
pages = {2188--2205},
224224
number = {8},
225225
doi = {10.1177/2399808320967680}
226-
}
226+
}
227+
228+
@article{araldi2024multi,
229+
author = {Araldi, Alessandro and Fusco, Giovanni},
230+
title = {Multi-Level Street-Based Analysis of the Urban Fabric: Developments for a Nationwide Taxonomy},
231+
journal = {Geographical Analysis},
232+
year = {2024},
233+
volume = {n/a},
234+
number = {n/a},
235+
pages = {},
236+
keywords = {morphotypes, streetscape morphometrics, urban fabric},
237+
doi = {https://doi.org/10.1111/gean.12416},
238+
url = {https://onlinelibrary.wiley.com/doi/abs/10.1111/gean.12416},
239+
eprint = {https://onlinelibrary.wiley.com/doi/pdf/10.1111/gean.12416},
240+
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.}
241+
}
242+

docs/api.rst

+17
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
.. _api_ref:
22

33
.. automodule:: momepy
4+
:members:
5+
:undoc-members:
46

57
.. currentmodule:: momepy
68

@@ -179,6 +181,21 @@ With utilities allowing conversion between networkx objects and GeoPandas object
179181
gdf_to_nx
180182
nx_to_gdf
181183

184+
185+
Measuring streetscape
186+
---------------------
187+
188+
Specialised class for the advanced streetscape analysis.
189+
190+
.. autosummary::
191+
:toctree: api/
192+
193+
Streetscape
194+
Streetscape.compute_plots
195+
Streetscape.compute_slope
196+
Streetscape.street_level
197+
Streetscape.point_level
198+
182199
Data preprocessing
183200
------------------
184201

0 commit comments

Comments
 (0)