SimplifyOgc Method (GeometryEngine)

In This Topic

Simplifies the given geometry according to the Open Geospatial Consortium (OGC) validation specification.

Syntax

Visual Basic (Declaration)
C#

Public Function SimplifyOgc( _
   ByVal geometry As Geometry, _
   ByVal forceSimplify As Boolean _
) As Geometry

public Geometry SimplifyOgc( 
   Geometry geometry,
   bool forceSimplify
)

Parameters

geometry: The geometry to be simplified.
forceSimplify: (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

The simplified geometry.

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 simplified using this method will be 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