Package org.geolatte.geom

Class JTSGeometryOperations

java.lang.Object

org.geolatte.geom.JTSGeometryOperations

All Implemented Interfaces:

ProjectedGeometryOperations

public class JTSGeometryOperations
extends Object
implements ProjectedGeometryOperations

An implementation of ProjectedGeometryOperations that delegates to the corresponding JTS operations.

Author:

Karel Maesen, Geovise BVBA creation-date: 5/3/11

Field Summary

Fields inherited from interface org.geolatte.geom.ProjectedGeometryOperations

Default

Constructor Summary

Constructors

Constructor	Description
JTSGeometryOperations()

Method Summary

Modifier and Type	Method	Description
<P extends C2D,G extends Geometry<P> & Polygonal<P>> double	area(G geometry)	Calculates the area of the specified Geometry.
<P extends C2D> Geometry<P>	boundary(Geometry<P> geometry)	Calculates the boundary of the specified Geometry.
<P extends C2D> Geometry<P>	buffer(Geometry<P> geometry, double distance)	Calculates a Geometry that represents all points whose distance from the specified Geometry is less than or equal the specified distance.
<P extends C2D,G extends Geometry<P> & Polygonal<P>> Point<P>	centroid(G geometry)	Calculates a centroid for the specified Geometry.
<P extends C2D> boolean	contains(Geometry<P> geometry, Geometry<P> other)	Checks if the first specified Geometry spatially contains the second.
<P extends C2D> Geometry<P>	convexHull(Geometry<P> geometry)	Calculates the convex hull of the specified Geometry.
<P extends C2D> boolean	crosses(Geometry<P> geometry, Geometry<P> other)	Checks if the specified Geometrys cross.
<P extends C2D> Geometry<P>	difference(Geometry<P> geometry, Geometry<P> other)	Calculates the point set difference of the specified Geometrys.
<P extends C2D> double	distance(Geometry<P> geometry, Geometry<P> other)	Calculates the shortest distance between any two points in the two Geometrys in the coordinate reference system of this Geometry.
<P extends C2D> Geometry<P>	intersection(Geometry<P> geometry, Geometry<P> other)	Calculates the point set intersection of the specified Geometrys.
<P extends C2D> boolean	intersects(Geometry<P> geometry, Geometry<P> other)	Checks if the specified Geometrys intersect.
<P extends C2D> boolean	isSimple(Geometry<P> geometry)	Tests the simplicity of the specified Geometry.
<P extends C2D,G extends Geometry<P> & Linear<P>> double	length(G geometry)	Calculates the length of the specified Geometry.
<P extends C2D> boolean	overlaps(Geometry<P> geometry, Geometry<P> other)	Checks if the specified Geometrys overlap.
<P extends C2D> boolean	relates(Geometry<P> geometry, Geometry<P> other, String matrix)	Checks if the specified Geometrys are spatially related by testing for intersections between the interior, boundary and exterior of the two geometric objects as specified by the values in the intersection pattern matrix.
<P extends C2D,G extends Geometry<P>> G	reverse(G geometry)	Creates a Geometry having as coordinates the coordinates of the input Geometry in reverse order.
<P extends C2D> Geometry<P>	symmetricDifference(Geometry<P> geometry, Geometry<P> other)	Calculates the point set symmetric difference of the specified Geometrys.
<P extends C2D> boolean	touches(Geometry<P> geometry, Geometry<P> other)	Checks if the specified Geometrys touch.
<P extends C2D> Geometry<P>	union(Geometry<P> geometry, Geometry<P> other)	Calculates the point set union of the specified Geometrys.

Methods inherited from class java.lang.Object

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

Constructor Detail

JTSGeometryOperations

public JTSGeometryOperations()

Method Detail

isSimple

public <P extends C2D> boolean isSimple(Geometry<P> geometry)

Description copied from interface: ProjectedGeometryOperations

Tests the simplicity of the specified Geometry.

Specified by:

isSimple in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry to test for simplicity.

Returns:

True iff the specified Geometry is simple.

boundary

public <P extends C2D> Geometry<P> boundary(Geometry<P> geometry)

Description copied from interface: ProjectedGeometryOperations

Calculates the boundary of the specified Geometry.

Specified by:

boundary in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry for which to calculate the boundary.

Returns:

a Geometry representing the boundary of the specified Geometry.

reverse

public <P extends C2D,G extends Geometry<P>> G reverse(G geometry)

Creates a Geometry having as coordinates the coordinates of the input Geometry in reverse order.

Specified by:

reverse in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry to reverse

Returns:

a Geometry with the same coordinates as the specified input Geometry but in reverse order

intersects

public <P extends C2D> boolean intersects(Geometry<P> geometry,
                                          Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Checks if the specified Geometrys intersect.

Specified by:

intersects in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry operand of the intersection test

other - the second Geometry operand of the intersection test

Returns:

true iff the specified Geometrys spatially intersect

touches

public <P extends C2D> boolean touches(Geometry<P> geometry,
                                       Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Checks if the specified Geometrys touch.

Specified by:

touches in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry operand of the touch test

other - the second Geometry operand of the touch test

Returns:

true iff the specified Geometrys spatially touch

crosses

public <P extends C2D> boolean crosses(Geometry<P> geometry,
                                       Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Checks if the specified Geometrys cross.

Specified by:

crosses in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry operand of the cross test

other - the second Geometry operand of the cross test

Returns:

true iff the specified Geometrys spatially cross

contains

public <P extends C2D> boolean contains(Geometry<P> geometry,
                                        Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Checks if the first specified Geometry spatially contains the second.

Specified by:

contains in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry operand of the containment test

other - the second Geometry operand of the containment test

Returns:

true iff the first specified Geometry spatially contains the second

overlaps

public <P extends C2D> boolean overlaps(Geometry<P> geometry,
                                        Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Checks if the specified Geometrys overlap.

Specified by:

overlaps in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry operand of the overlap test

other - the second Geometry operand of the overlap test

Returns:

true iff the specified Geometrys spatially overlap

relates

public <P extends C2D> boolean relates(Geometry<P> geometry,
                                       Geometry<P> other,
                                       String matrix)

Description copied from interface: ProjectedGeometryOperations

Checks if the specified Geometrys are spatially related by testing for intersections between the interior, boundary and exterior of the two geometric objects as specified by the values in the intersection pattern matrix. This returns false if all the tested intersections are empty except exterior (this) intersect exterior (another).

Specified by:

relates in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry operand of the relates test

other - the second Geometry operand of the relates test

matrix - the intersection pattern matrix

Returns:

true iff this instance intersects the specifed other Geometry

distance

public <P extends C2D> double distance(Geometry<P> geometry,
                                       Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Calculates the shortest distance between any two points in the two Geometrys in the coordinate reference system of this Geometry. Only the X/Y-coordinates are used in the distance calculation; M- and Z-coordinates are ignored.

Specified by:

distance in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry

other - the second Geometry

Returns:

the shortest distance between the two specified Geometries

buffer

public <P extends C2D> Geometry<P> buffer(Geometry<P> geometry,
                                          double distance)

Description copied from interface: ProjectedGeometryOperations

Calculates a Geometry that represents all points whose distance from the specified Geometry is less than or equal the specified distance.

Calculations are in the CoordinateReferenceSystem of this Geometry.

Z- or M-coordinates are ignored in the buffering operation; and the result will always be a 2D geometry.

Specified by:

buffer in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry for which to calculate the buffer

distance - the buffer distance

Returns:

a 2D Geometry representing the buffer of the specified Geometry with the specified distance.

convexHull

public <P extends C2D> Geometry<P> convexHull(Geometry<P> geometry)

Description copied from interface: ProjectedGeometryOperations

Calculates the convex hull of the specified Geometry.

Specified by:

convexHull in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry for which to calculate the convex hull.

Returns:

the convex hull for the specified Geometry.

intersection

public <P extends C2D> Geometry<P> intersection(Geometry<P> geometry,
                                                Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Calculates the point set intersection of the specified Geometrys.

Specified by:

intersection in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry

other - the second Geometry

Returns:

a Geometry representing the point set intersection between the two specified Geometries

union

public <P extends C2D> Geometry<P> union(Geometry<P> geometry,
                                         Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Calculates the point set union of the specified Geometrys.

Specified by:

union in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry

other - the second Geometry

Returns:

a Geometry representing the point set union between the two specified Geometries

difference

public <P extends C2D> Geometry<P> difference(Geometry<P> geometry,
                                              Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Calculates the point set difference of the specified Geometrys.

Specified by:

difference in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry

other - the second Geometry

Returns:

a Geometry representing the point set difference between the two specified Geometries

symmetricDifference

public <P extends C2D> Geometry<P> symmetricDifference(Geometry<P> geometry,
                                                       Geometry<P> other)

Description copied from interface: ProjectedGeometryOperations

Calculates the point set symmetric difference of the specified Geometrys.

Specified by:

symmetricDifference in interface ProjectedGeometryOperations

Parameters:

geometry - the first Geometry

other - the second Geometry

Returns:

a Geometry representing the point set symmetric difference between the two specified Geometries

length

public <P extends C2D,G extends Geometry<P> & Linear<P>> double length(G geometry)

Description copied from interface: ProjectedGeometryOperations

Calculates the length of the specified Geometry.

Specified by:

length in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry

Returns:

the length of the specified Geometry

area

public <P extends C2D,G extends Geometry<P> & Polygonal<P>> double area(G geometry)

Description copied from interface: ProjectedGeometryOperations

Calculates the area of the specified Geometry.

Specified by:

area in interface ProjectedGeometryOperations

Parameters:

geometry - the Geometry

Returns:

the area of the specified Geometry

centroid

public <P extends C2D,G extends Geometry<P> & Polygonal<P>> Point<P> centroid(G geometry)

Description copied from interface: ProjectedGeometryOperations

Calculates a centroid for the specified Geometry.

Specified by:

centroid in interface ProjectedGeometryOperations

G - Polygonal Geometry

Parameters:

geometry - the Geometry

Returns:

the centroid of the specified Geometry as a Point