momepy.CheckTessellationInput#
- class momepy.CheckTessellationInput(gdf, shrink=0.4, collapse=True, split=True, overlap=True)[source]#
Check input data for
Tessellation
for potential errors.Tessellation
requires data of relatively high level of precision and there are three particular patterns causing issues.1. Features will collapse into empty polygon - these do not have tessellation cell in the end.
2. Features will split into MultiPolygon - at some cases, features with narrow links between parts split into two during ‘shrinking’. In most cases that is not an issue and resulting tessellation is correct anyway, but sometimes this result in a cell being MultiPolygon, which is not correct.
3. Overlapping features - features which overlap even after ‘shrinking’ cause invalid tessellation geometry.
CheckTessellationInput
will check for all of these. Overlapping features have to be fixed prior Tessellation. Features which will split will cause issues only sometimes, so should be checked and fixed if necessary. Features which will collapse could be ignored, but they will have to excluded from next steps of tessellation-based analysis.- Parameters:
- gdfGeoDataFrame or GeoSeries
GeoDataFrame containing objects to be used as
gdf
inTessellation
- shrinkfloat (default 0.4)
distance for negative buffer
- collapsebool (default True)
check for features which would collapse to empty polygon
- splitbool (default True)
check for features which would split into Multi-type
- overlapbool (default True)
check for overlapping features (after negative buffer)
Examples
>>> check = CheckTessellationData(df) Collapsed features : 3157 Split features : 519 Overlapping features: 22
- Attributes:
- collapseGeoDataFrame or GeoSeries
features which would collapse to empty polygon
- splitGeoDataFrame or GeoSeries
features which would split into Multi-type
- overlapGeoDataFrame or GeoSeries
overlapping features (after negative buffer)
Methods
__init__
(gdf[, shrink, collapse, split, overlap])