Types for Spatial Operations ============================ The following types are used for spatial operation functions within GlobalMapper. These types use fixed, numeric constants, which are defined here. ------------------------------------------------------------------------------------------------------------------------ .. py:data:: globalmapper.GM_PredicateResultTargets_t8 Result targets for predicate results :values: **GM_PredicateResult_CreateNewSelection** = 0 Create new selection from matched features **GM_PredicateResult_AddToSelection** = 1 Add matched features to current selection **GM_PredicateResult_RemoveFromSelection** = 2 Remove matched features from current selection **GM_PredicateResult_CreateNewLayer** = 3 Clone matched features into a new layer **GM_PredicateResult_ReturnFeatures** = 4 Return matched via GM_FoundFeatureResults_t* ------------------------------------------------------------------------------------------------------------------------ .. py:data:: globalmapper.GM_SpatialOperations_t8 Spatial operation types :values: **GM_SpatialOps_Intersection** = 0 Returns the spatial intersection of two layers **GM_SpatialOps_Union** = 1 Returns the the spatial union of two layers, or among features of a single layer **GM_SpatialOps_Difference** = 2 Returns the the spatial difference between two layers **GM_SpatialOps_SymmetricDifference** = 3 Returns the the spatial symmetric difference between two layers ------------------------------------------------------------------------------------------------------------------------ .. py:data:: globalmapper.GM_SpatialOps_Errorhandling_t8 Flags specifying how to handle invalid input geometries :values: **GM_SpatialOps_OnErrorHalt** = 0 Halt further processing **GM_SpatialOps_OnErrorSkip** = 1 Skip invalid geometries **GM_SpatialOps_OnErrorIgnore** = 2 Use invalid geometries anyway ------------------------------------------------------------------------------------------------------------------------ .. py:data:: globalmapper.GM_SpatialPredicates_t16 Spatial predicate types :values: **GM_SpatialPredicates_Intersects** = 1 Calculates the set of features that intersect features in another layer **GM_SpatialPredicates_Overlaps** = 2 Calculates the set of features that overlap features in another layer **GM_SpatialPredicates_Touches** = 4 Calculates the set of features that touch features in another layer **GM_SpatialPredicates_Contains** = 8 Calculates the set of features that wholly contain features in another layer **GM_SpatialPredicates_IsEqual** = 16 Calculates the set of features that have have an exact match with the geometry of a feature in another layer **GM_SpatialPredicates_IsWithin** = 32 Calculates the set of features that are wholly contained by a feature in another layer **GM_SpatialPredicates_IsDisjoint** = 64 Calculates the set of features that do not intersect features in another layer ------------------------------------------------------------------------------------------------------------------------ .. py:data:: globalmapper.GM_SpatialTransforms_t16 Spatial transform types :values: **GM_SpatialTransform_MBR** = 1 Returns a bounding rectangle area feature for each grouping of a given layer **GM_SpatialTransform_Center** = 2 Returns a center point feature for each grouping of a given layer **GM_SpatialTransform_ConvexHull** = 3 Returns a convex hull area feature for each grouping of a given layer **GM_SpatialTransform_ConcaveHull** = 4 Returns a concave hull area feature for each grouping of a given layer **GM_SpatialTransform_Buffer** = 5 Returns a buffer area feature at a given distance from each grouping of a given layer ------------------------------------------------------------------------------------------------------------------------ .. py:data:: globalmapper.GM_FeatureGrouping_t8 Feature grouping for spatial transforms :values: **GM_GroupingNone** = 0x0001 No grouping; features are handled individually **GM_GroupingPartition** = 0x0002 Group features by attribute matching **GM_GroupingAll** = 0x0004 Include all features in a single group