mil.nga.wkb.util

Class GeometryUtils

java.lang.Object

mil.nga.wkb.util.GeometryUtils

public class GeometryUtils
extends Object

Utilities for Geometry objects

Since:

1.0.3

Author:

osbornb

Constructor Summary

Constructors

Constructor and Description
GeometryUtils()

Method Summary

Modifier and Type	Method and Description
static double	distance(Point point1, Point point2) Get the Pythagorean theorem distance between two points
static Point	getCentroid(Geometry geometry) Get the centroid point of the Geometry
static int	getDimension(Geometry geometry) Get the dimension of the Geometry, 0 for points, 1 for curves, 2 for surfaces.
static void	minimizeGeometry(Geometry geometry, double maxX) Minimize the geometry using the shortest x distance between each connected set of points.
static void	normalizeGeometry(Geometry geometry, double maxX) Normalize the geometry so all points outside of the min and max value range are adjusted to fall within the range.
static double	perpendicularDistance(Point point, Point lineStart, Point lineEnd) Calculate the perpendicular distance between the point and the line represented by the start and end points.
static List<Point>	simplifyPoints(List<Point> points, double tolerance) Simplify the ordered points (representing a line, polygon, etc) using the Douglas Peucker algorithm to create a similar curve with fewer points.

Methods inherited from class java.lang.Object

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

Constructor Detail

GeometryUtils

public GeometryUtils()

Method Detail

getDimension

public static int getDimension(Geometry geometry)

Get the dimension of the Geometry, 0 for points, 1 for curves, 2 for surfaces. If a collection, the largest dimension is returned.

Parameters:

geometry - geometry object

Returns:

dimension (0, 1, or 2)

distance

public static double distance(Point point1,
                              Point point2)

Get the Pythagorean theorem distance between two points

Parameters:

point1 - point 1

point2 - point 2

Returns:

distance

getCentroid

public static Point getCentroid(Geometry geometry)

Get the centroid point of the Geometry

Parameters:

geometry - geometry object

Returns:

centroid point

minimizeGeometry

public static void minimizeGeometry(Geometry geometry,
                                    double maxX)

Minimize the geometry using the shortest x distance between each connected set of points. The resulting geometry point x values will be in the range: (3 * min value <= x <= 3 * max value Example: For WGS84 provide a max x of 180.0. Resulting x values will be in the range: -540.0 <= x <= 540.0 Example: For web mercator provide a world width of 20037508.342789244. Resulting x values will be in the range: -60112525.028367732 <= x <= 60112525.028367732

Parameters:

geometry - geometry

maxX - max positive x value in the geometry projection

normalizeGeometry

public static void normalizeGeometry(Geometry geometry,
                                     double maxX)

Normalize the geometry so all points outside of the min and max value range are adjusted to fall within the range. Example: For WGS84 provide a max x of 180.0. Resulting x values will be in the range: -180.0 <= x <= 180.0. Example: For web mercator provide a world width of 20037508.342789244. Resulting x values will be in the range: -20037508.342789244 <= x <= 20037508.342789244.

Parameters:

geometry - geometry

maxX - max positive x value in the geometry projection

simplifyPoints

public static List<Point> simplifyPoints(List<Point> points,
                                         double tolerance)

Simplify the ordered points (representing a line, polygon, etc) using the Douglas Peucker algorithm to create a similar curve with fewer points. Points should be in a meters unit type projection. The tolerance is the minimum tolerated distance between consecutive points.

Parameters:

points - geometry points

tolerance - minimum tolerance in meters for consecutive points

Returns:

simplified points

Since:

1.0.4

perpendicularDistance

public static double perpendicularDistance(Point point,
                                           Point lineStart,
                                           Point lineEnd)

Calculate the perpendicular distance between the point and the line represented by the start and end points. Points should be in a meters unit type projection.

Parameters:

point - point

lineStart - point representing the line start

lineEnd - point representing the line end

Returns:

distance in meters

Since:

1.0.4