rs_common/geometry_fix.md¶
This module is used to share common functions between apis and to fix the malformed generated products by a processor. It is not part of the Sonarqube coverage part, because it is a temporary fix of the malformed generated products by a processor. The processor should be fixed in the future, and this module should be removed.
fix_geojson_geometry(item)
¶
Repair invalid GeoJSON if needed and enforce RFC7946 ring orientation on polygonal results.
This function is a wrapper around repair_and_orient_geojson_geometry that logs any exceptions raised during the repair process. If an exception occurs, the original geometry is returned unchanged.
Source code in docs/rs-client-libraries/rs_common/geometry_fix.py
looks_like_swath_polygon(geometry)
¶
Return True for a polygon that can be rebuilt as a swath strip.
Criteria: - no interior rings/holes; - at least four exterior points, excluding closure; - an even number of exterior points, so the ring can be split into two paired edges.
Source code in docs/rs-client-libraries/rs_common/geometry_fix.py
polygon_parts(geometry)
¶
Return the non-empty polygons contained in a geometry, flattening multi-parts and collections.
Source code in docs/rs-client-libraries/rs_common/geometry_fix.py
rebuild_swath_polygon(geometry)
¶
Rebuild a two-edge swath footprint into antimeridian-safe geometry.
The polygon exterior is interpreted as two paired swath edges: the first half of the coordinates is one edge, and the reversed second half is the opposite edge. The footprint is rebuilt as consecutive quadrilateral cells between paired vertices. Each cell is fixed for +/-180 longitude crossings, then the fixed polygon parts are unioned back into a Polygon or MultiPolygon.
References: - GeoJSON antimeridian cutting: https://www.rfc-editor.org/rfc/rfc7946#section-3.1.9 - antimeridian segmentation algorithm: https://www.gadom.ski/antimeridian/v0.4.5/the-algorithm/ - antimeridian.fix_shape API: https://www.gadom.ski/antimeridian/v0.4.5/api/#antimeridian.fix_shape
Source code in docs/rs-client-libraries/rs_common/geometry_fix.py
reduce_geometry_collection(geometry)
¶
Reduce a GeometryCollection to its highest-dimension parts.
make_valid can return a GeometryCollection when an invalid polygon contains collapsed parts, e.g. a Polygon plus a degenerate LineString for a spike made of two almost identical vertices. These lower-dimension parts are repair artifacts, not footprint information, so keep only the parts of the highest dimension (polygons, otherwise lines, otherwise points) and return them as a Polygon/MultiPolygon, LineString/MultiLineString or Point/MultiPoint. Other geometry types are returned unchanged.
Only call it on a collection created by make_valid: a GeometryCollection provided as is by a processor is legitimate data and must be kept.
Source code in docs/rs-client-libraries/rs_common/geometry_fix.py
repair_and_orient_geojson_geometry(geometry)
¶
Repair invalid GeoJSON if needed and enforce RFC7946 ring orientation on polygonal results.