IsSimpleOgc Method (GeometryEngine)

In This Topic

Indicates if the given geometry is topologically consistent according to the Open Geospatial Consortium (OGC) validation specification.

Syntax

Visual Basic (Declaration)
C#

Public Function IsSimpleOgc( _
   ByVal geometry As Geometry, _
   ByRef nonSimpleReason As NonSimpleReason, _
   ByVal forceIsSimple As Boolean _
) As Boolean

public bool IsSimpleOgc( 
   Geometry geometry,
   out NonSimpleReason nonSimpleReason,
   bool forceIsSimple
)

Parameters

geometry: The geometry to be simplified.
nonSimpleReason: The reason that the geometry is non-simple.
forceIsSimple: (Optional) The default value is false. When true, it forces the simplification code to be applied to the geometry even if the geometry comes from a trusted source or has already been simplified. When false, the method will do nothing if called on the same geometry a second time.

Return Value

Returns true if the geometry is simple and false otherwise.

Exceptions

Exception	Description
System.ArgumentNullException	The input geometry is null.
System.NotImplementedException	The method is not implemented for GeometryBag or Multipatch.

Remarks

The OGC specification is defined in OpenGIS Implementation Standard for Geographic information – simple feature access – Part 1: common architecture.

A geometry that is OGC simple is simple for IsSimpleAsFeature and SimplifyAsFeature.

Example

SimplifyOGC

{
  SpatialReference sr = SpatialReferences.WGS84;

  Coordinate2D[] coords = [new Coordinate2D(5, 10), new Coordinate2D(15, 20), new Coordinate2D(25, 10), new Coordinate2D(5, 20)];
  polyline = PolylineBuilderEx.CreatePolyline(coords, sr);
  // polyline.IsKnownSimpleOgc = false
  // polyline.IsKnownSimple = false

  bool isSimple = GeometryEngine.Instance.IsSimpleOgc(polyline, out NonSimpleReason nonSimpleReason, true);
  // isSimple = false
  // nonSimpleReason = NonSimpleReason.SelfIntersections

  Polyline simplePolyline = GeometryEngine.Instance.SimplifyOgc(polyline) as Polyline;
  // simplePolyline.IsKnownSimpleOgc = true
  // simplePolyline.IsKnownSimple = true

  double resolution = sr.XYResolution;
  Coordinate3D[] coords3D = [ new Coordinate3D(0, 0, 0), new Coordinate3D(0, 1.8 * resolution, 0.8 * sr.ZTolerance), new Coordinate3D(10, 10, 1),
new Coordinate3D(0, 5, 1) ];
  polyline = PolylineBuilderEx.CreatePolyline(coords3D, sr);

  isSimple = GeometryEngine.Instance.IsSimpleOgc(polyline, out nonSimpleReason);
  // isSimple = false
  // nonSimpleReason = NonSimpleReason.ShortSegments

  simplePolyline = GeometryEngine.Instance.SimplifyOgc(polyline, true) as Polyline;
  // simplePolyline.IsKnownSimpleOgc = true
  // simplePolyline.IsKnownSimple = true

  coords = [new Coordinate2D(0, 0), new Coordinate2D(0, 0)];
  Multipoint multipoint = MultipointBuilderEx.CreateMultipoint(coords, sr);

  isSimple = GeometryEngine.Instance.IsSimpleOgc(multipoint, out nonSimpleReason);
  // isSimple = false
  // nonSimpleReason = NonSimpleReason.DuplicateVertex
}

Requirements

Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.2 or higher.

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback