org.opengis.cite.iso19136.data.spatial

Class GeometryAssert

java.lang.Object

org.opengis.cite.iso19136.data.spatial.GeometryAssert

public class GeometryAssert
extends Object

Provides specialized assertion methods that apply to representations of geometry objects.

Method Summary

Modifier and Type	Method and Description
static void	assertAllCurveSegmentsHaveRequiredLength(Element gmlCurve) Asserts that the number of direct positions in the posList element appearing within each segment of the given curve geometry satisfies the minimum length requirements.
static void	assertCoordinateEquals(com.vividsolutions.jts.geom.Coordinate actualPos, com.vividsolutions.jts.geom.Coordinate expectedPos, int tolerancePPM, String message) Asserts that the given Coordinate tuples are equal within the specified tolerance.
static void	assertCurveComponentsAreConnected(Element gmlCurve) Asserts that the components of a composite curve are connected; that is, the orientation of the curve members is such that each component (except the first) begins where the preceding one ends.
static void	assertCurveSegmentsAreConnected(Element gmlCurve) Asserts that all segments of a curve are connected; that is, the end point of each segment (except the last) is identical to the start point of the next segment.
static void	assertGeometryCoveredByValidArea(org.geotoolkit.gml.xml.v321.AbstractGeometryType gmlGeom) Asserts that the given geometry element is covered by the valid area of its associated CRS.
static void	assertValidCRS(Element geom) Asserts that the given geometry element has a valid CRS reference.
static void	assertValidSurfaceBoundary(Element surfaceElem) Asserts that the boundary of the given surface is topologically correct.
(package private) static void	assertValidSurfaceOrientation(Element surfaceElem) Asserts that the boundary of the given surface is correctly oriented with respect to the upward normal.
(package private) static void	removeConsecutiveDuplicates(List<com.vividsolutions.jts.geom.Coordinate> coordList, double tolerancePPM)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

assertValidCRS

public static void assertValidCRS(Element geom)

Asserts that the given geometry element has a valid CRS reference. The value of the srsName attribute is an absolute URI that either identifies a "well-known" CRS definition or refers to a CRS definition. The reference may be inherited from a containing geometry (aggregate) or feature envelope.

Parameters:

geom - A DOM Element node representing a GML geometry element (or an element that can be substituted for one).

See Also:

"ISO 19136: cl. 9.10, 10.1.3.2"

assertGeometryCoveredByValidArea

public static void assertGeometryCoveredByValidArea(org.geotoolkit.gml.xml.v321.AbstractGeometryType gmlGeom)

Asserts that the given geometry element is covered by the valid area of its associated CRS.

WARNING: May be problematic for 3D coordinates.

Parameters:

gmlGeom - A GML geometry element.

assertAllCurveSegmentsHaveRequiredLength

public static void assertAllCurveSegmentsHaveRequiredLength(Element gmlCurve)

Asserts that the number of direct positions in the posList element appearing within each segment of the given curve geometry satisfies the minimum length requirements. The number of entries in a posList element is equal to the product of the dimensionality of the CRS and the number of direct positions. An additional check ensures that the number of entries is consistent with the CRS even if the minimum length constraint is satisfied; that is, size(posList) % dimCRS = 0.

Parameters:

gmlCurve - An Element node representing a GML curve geometry (gml:Curve or gml:LineString)

assertCurveSegmentsAreConnected

public static void assertCurveSegmentsAreConnected(Element gmlCurve)

Asserts that all segments of a curve are connected; that is, the end point of each segment (except the last) is identical to the start point of the next segment.

Parameters:

gmlCurve - An Element node representing a gml:Curve element.

assertCurveComponentsAreConnected

public static void assertCurveComponentsAreConnected(Element gmlCurve)

Asserts that the components of a composite curve are connected; that is, the orientation of the curve members is such that each component (except the first) begins where the preceding one ends.

Parameters:

gmlCurve - An Element node representing a gml:CompositeCurve element.

assertCoordinateEquals

public static void assertCoordinateEquals(com.vividsolutions.jts.geom.Coordinate actualPos,
                                          com.vividsolutions.jts.geom.Coordinate expectedPos,
                                          int tolerancePPM,
                                          String message)

Asserts that the given Coordinate tuples are equal within the specified tolerance.

Parameters:

actualPos - The actual position.

expectedPos - The expected position.

tolerancePPM - The maximum tolerable difference between tuple elements, expressed in parts per million (ppm).

message - The assertion error message.

assertValidSurfaceBoundary

public static void assertValidSurfaceBoundary(Element surfaceElem)

Asserts that the boundary of the given surface is topologically correct. Each boundary component (curve) must be:

1. simple (does not self-intersect at points other than boundary points), and
2. closed (forms a cycle).

Furthermore, each interior ring must be covered by the surface delimited by the exterior boundary (the rings may touch at a tangent point). Note: Surface patches based on parametric curves are not supported.

Parameters:

surfaceElem - A DOM Element node representing a surface geometry (substitutes for gml:AbstractSurface).

assertValidSurfaceOrientation

static void assertValidSurfaceOrientation(Element surfaceElem)

Asserts that the boundary of the given surface is correctly oriented with respect to the upward normal. In essence, the interior of the surface (patch) is always to the left of a boundary curve. The following constraints must be satisfied:

1. the exterior ring is oriented in a counter-clockwise (CCW) direction, and
2. all interior rings are oriented in a clockwise (CW) direction.

Parameters:

surfaceElem - A DOM Element node representing a surface geometry (substitutes for gml:AbstractSurface).

removeConsecutiveDuplicates

static void removeConsecutiveDuplicates(List<com.vividsolutions.jts.geom.Coordinate> coordList,
                                        double tolerancePPM)