org.opengis.spatialschema.geometry.primitive
Interface SurfaceBoundary

All Superinterfaces:

Boundary, Complex, Geometry, PrimitiveBoundary, TransfiniteSet

public interface SurfaceBoundary

extends PrimitiveBoundary

The boundary of surfaces. A SurfaceBoundary consists of some number of rings, corresponding to the various components of its boundary. In the normal 2D case, one of these rings is distinguished as being the exterior boundary. In a general manifold this is not always possible, in which case all boundaries shall be listed as interior boundaries, and the exterior will be empty.

NOTE: The use of exterior and interior here is not intended to invoke the definitions of "interior" and "exterior" of geometric objects. The terms are in common usage, and reflect a linguistic metaphor that uses the same linguistic constructs for the concept of being inside an object to being inside a container. In normal mathematical terms, the exterior boundary is the one that appears in the Jordan Separation Theorem (Jordan Curve Theorem extended beyond 2D). The exterior boundary is the one that separates the surface (or solid in 3D) from infinite space. The interior boundaries separate the object at hand from other bounded objects. The uniqueness of the exterior comes from the uniqueness of unbounded space. Essentially, the Jordan Separation Theorem shows that normal 2D or 3D space separates into bounded and unbounded pieces by the insertion of a ring or shell, respectively. It goes beyond that, but this specification is restricted to at most 3 dimensions.

EXAMPLE 1: If the underlying manifold is an infinite cylinder, then two transverse cuts of the cylinder define a compact surface between the cuts, and two separate unbounded portions of the cylinders. In this case, either cut could reasonably be called exterior. In cases of such ambiguity, the standard chooses to list all boundaries in the "interior" set. The only guarantee of an exterior boundary being unique is in the 2-dimensional plane, E².

EXAMPLE 2: Taking the equator of a sphere, and generating a 1 meter buffer, we have a surface with two isomorphic boundary components. There is no unbiased manner to distinguish one of these as an exterior.

Version:

2.0

Author:

ISO/DIS 19107, OpenGIS® consortium

See Also:

SolidBoundary

UML identifier (abstract type): GM_SurfaceBoundary

Method Summary

Ring	getExterior() Returns the exterior ring, or null if none.
Ring[]	getInteriors() Returns the interior rings.

Methods inherited from interface Boundary

isCycle

Methods inherited from interface Complex

getElements, getSubComplexes, getSuperComplexex, isMaximal

Methods inherited from interface Geometry

getBoundary, getBuffer, getCentroid, getClosure, getConvexHull, getCoordinateDimension, getCoordinateReferenceSystem, getDimension, getDistance, getEnvelope, getMaximalComplex, getMbRegion, getRepresentativePoint, isSimple, transform, transform

Methods inherited from interface TransfiniteSet

contains, contains, difference, equals, intersection, intersects, symmetricDifference, union

Method Detail

getExterior

Ring getExterior()

Returns the exterior ring, or null if none.

Returns:

The exterior ring, or null.

UML identifier (operation): exterior

getInteriors

Ring[] getInteriors()

Returns the interior rings.

Returns:

The interior rings. Never null, but may be an empty array.

UML identifier (operation): interior