Interface IRelationalOperator

Namespace
ESRI.ArcGIS.Geometry
Assembly
ESRI.Server.Geometry.dll

Provides access to members that determine if a certain spatial relationship exists between two geometries.

[Guid("1B07790E-38C5-11D0-92D2-00805F7C28B0")]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
public interface IRelationalOperator

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

 

RelationalOperator Boundary/Interior Example

 

Relational operators has now been extended to support 3D polylines and that process can be generalized in three steps:

  • The polyline is converted to a 2D hybrid polyline.
  • Each of the base inputs is related to some parts of the comparison input.
  • The resulting relations are collected, and a rule is applied to determine the overall result relation.

Please refer to the topic "Working with Vertical Segments" in "Learning ArcObject" section in the help.

 

 

Methods

Contains(IGeometry)

Indicates if this geometry contains the other geometry.

bool Contains(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

If geometry1 Contains geometry2, then geometry2 is Within geometry1.

An empty geometry does not contain another geometry.  On the other hand, an empty geometry is contained in another geometry, unless the other geometry is empty.

Contains examples. Only "true" relationships are showed in this picture.

Crosses(IGeometry)

Indicates if the two geometries intersect in a geometry of lesser dimension.

bool Crosses(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

Cross only applies to polyline/polyline, polyline/polygon, or polygon/polyline relations.

If either one of the geometries is empty, the geometries do not cross.

Crosses examples. Only "true" relationships are showed in this picture.

Disjoint(IGeometry)

Indicates if the two geometries share no points in common. Negate this result to compute the Intersect relation.

bool Disjoint(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

Two geometries are disjoint if either one is empty.

Disjoint example. Only "true" relationships are showed in this picture.

Equals(IGeometry)

Indicates if the two geometries are of the same type and define the same set of points in the plane.

bool Equals(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries. GeometryBags are not supported. IRelationalOperator::Equals delegates to ITopologicalOperatorSymmetricDifference and returns true when that method returns an empty geometry; M's and Z's are ignored. Please use IClone::IsEqual if M's and Z's need to be compared.

IClone::IsEqual simply iterates over each segment in each geometry, in index order, and compares their types and coordinates (but using the spatial reference's cluster tolerances to determine equality of coordinates).

Only "true" relationships are showed in this picture.

[C#]

The RCW for the IRelationalOperator inherits from System.Object, as do all reference types in .NET. The System.Object type has a method called Equals, which results in the IRelationalOperator RCW having two overloaded versions of the Equals method. Ensure that you are not using the Equals method inherited from the System.Object class by mistake, by making sure you pass in an IGeometry reference to the Equals method. For example, the following extract of code from a C# console application demonstrates calling Equals correctly.

ESRI.ArcGIS.Geometry.IPoint pt1 = new ESRI.ArcGIS.Geometry.PointClass();
pt1.PutCoords(5, 5);

ESRI.ArcGIS.Geometry.IPoint pt2 = new ESRI.ArcGIS.Geometry.PointClass(); pt2.PutCoords(5, 5);

ESRI.ArcGIS.Geometry.IRelationalOperator rel1 = pt1 as ESRI.ArcGIS.Geometry.IRelationalOperator; ESRI.ArcGIS.Geometry.IGeometry geom2 = pt2 as ESRI.ArcGIS.Geometry.IGeometry;

bool relEqual = rel1.Equals(pt2); //calling IRelationalOperator::Equals Console.WriteLine("Equal: " + relEqual.ToString()); bool netEqual = rel1.Equals(pt2 as object); //calling Object::Equals Console.WriteLine("Equal: " + netEqual.ToString());

Overlaps(IGeometry)

Indicates if the intersection of the two geometries has the same dimension as one of the input geometries.

bool Overlaps(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

Overlaps only applies to polyline/polyline, polygon/polygon and multipoint/multipoint relations.

Two geometries do not overlap if either one is empty.

Overlaps examples. Only "true" relationships are showed in this picture.

Relation(IGeometry, string)

Indicates if the defined relationship exists.

bool Relation(IGeometry other, string relationDescription)

Parameters

other IGeometry
relationDescription string

Returns

bool

Remarks

Here is a VBA example of using the "RELATE" function to detect overlapping polylines. It assumes two polyline features are selected. G1 and G2 are placeholders for, in this example, the VBA variables r1 and r2.

Option Explicit

Public Sub overlapstest()
Dim ef As IEnumFeature
Dim d As IMxDocument
Set d = ThisDocument
Set ef = d.FocusMap.FeatureSelection
Dim r1 As IRelationalOperator, r2 As IRelationalOperator
Set r1 = ef.Next.Shape
Set r2 = ef.Next.Shape






Debug.Print "relation:", r1.Relation(r2, "RELATE(G1, G2, ""1********"")")

End Sub

Touches(IGeometry)

Indicates if the boundaries of the geometries intersect.

bool Touches(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

Touch does not apply for point/point comparison.

If either one of the two geometries is empty, the geometries are not touched.

 

Within(IGeometry)

Indicates if this geometry is contained (is within) another geometry.

bool Within(IGeometry other)

Parameters

other IGeometry

Returns

bool

Remarks

Only geometries that support the IRelationalOperator interface can be used as input geometries.

If geometry1 is Within geometry2, then geometry2 Contains geometry1.

An empty geometry is within another geometry, unless the other geometry is empty.

Within examples. Only "true" relationships are showed in this picture.