SpatialOperations

An OpenSpirit activity that performs spatial operations on two geometry inputs. The geometry types supported are Point, Line String and Polygon. The spatial operations that can be performed are: Contains, Crosses, Disjoint, Intersects, Overlaps, Touches and Within.

General

The General tab contains the following fields.

Field Module Property? Description
Name No The name to be displayed as the label for the activity in the process.
First Geometry No Specifies the first geometry type. The options are: Point, Polygon, Line String and Esri WKT (See the Input section below on how these options effect the input). The default first geometry is Point.
Spatial Operator No Specifies the spatial operation to perform on the two geometries. The options are: Contains, Crosses, Disjoint, Intersects, Overlaps, Touches and Within. The default operator is "Within". The Spatial Operators table contains definitions of these operators.
Second Geometry No Specifies the second geometry type. The options are Point, Polygon, Line String and Esri WKT (See the Input section below on how these options effect the input). The default second geometry is Polygon.

Description

Provide a short description for the activity.

Input

The following is the input for the activity.

Input Item Data Type Description
OspInput Complex Root element for all input elements
FirstGeometry Complex This will either be a Point, Polygon or Line String depending on the "First Geometry" combo box setting on the configuration panel. If "Esri WKT" is chosen, this field will not be displayed.
FirstEsriWKT String The Esri WKT for the first geometry. The value must represent a Point, Polygon or Line String. This input is only shown if "Esri WKT" is chosen in the "First Geometry" combo box.
FirstCRS OspCRS The coordinate system for the first geometry. This input is only shown if "Esri WKT" is chosen in the "First Geometry" combo box.
SpatialOperator String Optionally supply the spatial operator at runtime. If supplied, this value will override the "Spatial Operator" combo box on the configuration panel.
SecondGeometry Complex This will either be a Point, Polygon or Line String depending on the "Second Geometry" combo box setting on the configuration panel. If "Esri WKT" is chosen, this field will not be displayed.
SecondEsriWKT String The Esri WKT for the second geometry. The value must represent a Point, Polygon or Line String. This input is only shown if "Esri WKT" is chosen in the "Second Geometry" combo box.
SecondCRS OspCRS The coordinate system for the second geometry. This input is only shown if "Esri WKT" is chosen in the "Second Geometry" combo box.

Output

The following is the output for the activity.

Output Item Data Type Description
OspOutput Complex Root element for all output elements
FirstGeometry Complex This will either be a Point, Polygon or Line String depending on the "First Geometry" combo box setting on the configuration panel. If "Esri WKT" is chosen, this field will not be displayed.
FirstEsriWKT String The Esri WKT for the first geometry. The value must represent a Point, Polygon or Line String. This input is only shown if "Esri WKT" is chosen in the "First Geometry" combo box.
FirstCRS OspCRS The coordinate system for the first geometry. This input is only shown if "Esri WKT" is chosen in the "First Geometry" combo box.
SpatialOperator String Optionally supply the spatial operator at runtime. If supplied, this value will override the "Spatial Operator" combo box on the configuration panel.
SecondGeometry Complex This will either be a Point, Polygon or Line String depending on the "Second Geometry" combo box setting on the configuration panel. If "Esri WKT" is chosen, this field will not be displayed.
SecondEsriWKT String The Esri WKT for the second geometry. The value must represent a Point, Polygon or Line String. This input is only shown if "Esri WKT" is chosen in the "Second Geometry" combo box.
SecondCRS OspCRS The coordinate system for the second geometry. This input is only shown if "Esri WKT" is chosen in the "Second Geometry" combo box.
Result Boolean The result of the spatial operator being applied to the two geometries.

Fault

The Fault tab lists exceptions that are thrown by this activity.

Error Schema Element Datatype Description
msg string The error message returned by the plug-in.
msgCode string The error code returned by the plug-in
Fault Thrown When...

Spatial Operators

Spatial Operator Description
Contains The first geometry Contains the second if the second is Within the first. See the definition of Within below.
Crosses For two objects to cross, their Interiors must intersect and the Interior of one must intersect the Exterior of the other.. Examples:
         
Disjoint Two geometries are disjoint if neither their interiors nor boundaries intersect. Examples:
         
Intersects Two geometries Intersect if they are not Disjoint. See the definition of Disjoint above. Examples:
         
Overlaps Two geometries overlap if their interiors intersect and the interior of each intersects the exterior of the other. Examples:
         
Touches Two geometries touch if their boundaries intersect the other's interiors or their boundaries intersect, but their interiors do not intersect. For instance, a point can touch a non-closed line segment only at the end-points (its boundaries). Examples:
         
Within The first geometry is within the second geometry if the interiors of both geometries intersect, but the interior and boundary of the first does not intersect the exterior of the second. Examples: