org.opengis.cite.geomatics

Class TopologicalRelationships

java.lang.Object

org.opengis.cite.geomatics.TopologicalRelationships

public class TopologicalRelationships
extends Object

Provides methods to test for the existence of a specified spatial relationship between two geometric objects.

See Also:

OpenGIS Implementation Specification for Geographic information - Simple feature access - Part 1: Common architecture

Constructor Summary

Constructors

Constructor and Description
TopologicalRelationships()

Method Summary

Modifier and Type	Method and Description
static boolean	isBeyond(Node g1, Node g2, Node distance)
static boolean	isSpatiallyRelated(SpatialRelationship predicate, Node node1, Node node2) Determines whether or not two GML geometry representations are spatially related in some manner (e.g.
static boolean	isWithinDistance(Node g1, Node g2, Node distance)
(package private) static Geometry	setCRS(Geometry g1, CoordinateReferenceSystem crs) Checks that the given geometry object uses the specified CRS.
(package private) static Geometry	toJTSGeometry(org.geotoolkit.gml.xml.AbstractGeometry gmlGeom) Builds a JTS geometry object from a GML geometry object.
(package private) static org.geotoolkit.gml.xml.AbstractGeometry	unmarshal(Node geomNode) Creates a GML geometry object from a DOM node.

Methods inherited from class java.lang.Object

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

Constructor Detail

TopologicalRelationships

public TopologicalRelationships()

Method Detail

isSpatiallyRelated

public static boolean isSpatiallyRelated(SpatialRelationship predicate,
                                         Node node1,
                                         Node node2)

Determines whether or not two GML geometry representations are spatially related in some manner (e.g. g1 contains g2). If the geometry representations have different CRS references, an attempt will be made to change coordinates from one CRS to another through the application of a coordinate operation (conversion or transformation).

Parameters:

predicate - A spatial relationship (predicate).

node1 - An Element node representing a GML geometry object.

node2 - An Element node representing another GML geometry object.

Returns:

true if the geometries satisfy the given spatial relationship ; false otherwise.

isBeyond

public static boolean isBeyond(Node g1,
                               Node g2,
                               Node distance)

isWithinDistance

public static boolean isWithinDistance(Node g1,
                                       Node g2,
                                       Node distance)

toJTSGeometry

static Geometry toJTSGeometry(org.geotoolkit.gml.xml.AbstractGeometry gmlGeom)

Builds a JTS geometry object from a GML geometry object.

Parameters:

gmlGeom - A GML geometry.

Returns:

A JTS geometry, or null if one could not be constructed.

unmarshal

static org.geotoolkit.gml.xml.AbstractGeometry unmarshal(Node geomNode)

Creates a GML geometry object from a DOM node.

Parameters:

geomNode - A node representing a GML geometry instance.

Returns:

A geometry object.

setCRS

static Geometry setCRS(Geometry g1,
                       CoordinateReferenceSystem crs)
                throws FactoryException,
                       TransformException

Checks that the given geometry object uses the specified CRS. If this is not the case, an attempt is made to change it.

Parameters:

g1 - A JTS geometry object.

crs - The target CRS.

Returns:

A Geometry object that uses the indicated CRS (the original geometry if its CRS was unchanged).

Throws:

FactoryException - If a CRS cannot be identified (e.g. a missing or invalid reference).

TransformException - If any coordinate operation (conversion or transformation) fails.