org.locationtech.geowave.core.geotime.util

Class GeometryUtils

java.lang.Object

org.locationtech.geowave.core.geotime.util.GeometryUtils

public class GeometryUtils
extends Object

This class contains a set of Geometry utility methods that are generally useful throughout the GeoWave core codebase

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GeometryUtils.GeoConstraintsWrapper
static interface	GeometryUtils.GeometryHandler

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_CRS_STR
static org.locationtech.jts.geom.GeometryFactory	GEOMETRY_FACTORY
static Integer	MAX_GEOMETRY_PRECISION
static org.locationtech.jts.geom.prep.PreparedGeometryFactory	PREPARED_GEOMETRY_FACTORY

Constructor Summary

Constructors

Constructor and Description
GeometryUtils()

Method Summary

Modifier and Type	Method and Description
static double	adjustCoordinateDimensionToRange(double val, org.opengis.referencing.crs.CoordinateReferenceSystem crs, int axis) This is perhaps a brain dead approach to do this, but it does handle wrap around cases.
static org.locationtech.jts.geom.Coordinate	adjustCoordinateToFitInRange(org.opengis.referencing.crs.CoordinateReferenceSystem crs, org.locationtech.jts.geom.Coordinate coord) Make sure the coordinate falls in the range of provided coordinate reference systems's coordinate system.
static org.locationtech.jts.geom.Geometry	adjustGeo(org.opengis.referencing.crs.CoordinateReferenceSystem crs, org.locationtech.jts.geom.Geometry geometry) Consume a geometry that may be over the ranges of the CRS (e.g date-line crossing).
static BasicQueryByClass.ConstraintSet	basicConstraintSetFromEnvelope(org.locationtech.jts.geom.Envelope env) This utility method will convert a JTS envelope to contraints that can be used in a GeoWave query.
static Constraints	basicConstraintsFromEnvelope(org.locationtech.jts.geom.Envelope env) This utility method will convert a JTS envelope to contraints that can be used in a GeoWave query.
static BasicQueryByClass.ConstraintsByClass	basicConstraintsFromGeometry(org.locationtech.jts.geom.Geometry geometry)
static BasicQueryByClass.ConstraintSet	basicConstraintsFromPoint(double latitudeDegrees, double longitudeDegrees) This utility method will convert a JTS envelope to that can be used in a GeoWave query.
static GeometryUtils.GeoConstraintsWrapper	basicGeoConstraintsWrapperFromGeometry(org.locationtech.jts.geom.Geometry geometry) This utility method will convert a JTS geometry to contraints that can be used in a GeoWave query.
static org.apache.commons.lang3.tuple.Pair<org.locationtech.jts.geom.Geometry,Double>	buffer(org.opengis.referencing.crs.CoordinateReferenceSystem crs, org.locationtech.jts.geom.Geometry geometry, String distanceUnits, double distance) Build a buffer around a geometry
static List<org.locationtech.jts.geom.Polygon>	constructGeometriesOverMapRegions(org.locationtech.jts.geom.Coordinate modifier, org.locationtech.jts.geom.Geometry geometry) Produce a set of polygons for each region of the map corrected for date line and hemisphere crossings.
static boolean	crsMatches(String crsCode1, String crsCode2)
static org.locationtech.jts.geom.Geometry	crsTransform(org.locationtech.jts.geom.Geometry geometry, org.opengis.referencing.operation.MathTransform transform)
static org.opengis.feature.simple.SimpleFeature	crsTransform(org.opengis.feature.simple.SimpleFeature entry, org.opengis.feature.simple.SimpleFeatureType reprojectedType, org.opengis.referencing.operation.MathTransform transform)
static org.opengis.referencing.crs.CoordinateReferenceSystem	decodeCRS(String crsCode)
static List<org.locationtech.jts.geom.Polygon>	fixRangeOfCoordinates(org.opengis.referencing.crs.CoordinateReferenceSystem crs, org.locationtech.jts.geom.Geometry geometry) Adjust geometry so that coordinates fit into long/lat bounds.
static org.locationtech.jts.geom.Geometry	geometryFromBinary(byte[] binary, Integer precision) Converts a byte array as well-known binary to a JTS geometry
static org.locationtech.jts.geom.Geometry	geometryFromBinary(byte[] binary, Integer precision, byte serializationVersion) Converts a byte array as well-known binary to a JTS geometry
static byte[]	geometryToBinary(org.locationtech.jts.geom.Geometry geometry, Integer precision) Converts a JTS geometry to binary using JTS a Well Known Binary writer
static org.opengis.filter.spatial.SpatialOperator	geometryToSpatialOperator(org.locationtech.jts.geom.Geometry jtsGeom, String geometryAttributeName, org.opengis.referencing.crs.CoordinateReferenceSystem crs)
static MultiDimensionalNumericData	getBoundsFromEnvelope(org.locationtech.jts.geom.Envelope envelope)
static String	getCrsCode(org.opengis.referencing.crs.CoordinateReferenceSystem crs)
static org.opengis.referencing.crs.CoordinateReferenceSystem	getDefaultCRS()
static org.opengis.referencing.crs.CoordinateReferenceSystem	getIndexCrs(Index index)
static org.opengis.referencing.crs.CoordinateReferenceSystem	getIndexCrs(Index[] indices)
static org.locationtech.jts.geom.Geometry	infinity() This mehtod returns an envelope between negative infinite and positive inifinity in both x and y
static void	initClassLoader()
static boolean	isDefaultCrs(org.opengis.referencing.crs.CoordinateReferenceSystem crs)
static boolean	isDefaultCrs(String crsCode)
static javax.measure.Unit<javax.measure.quantity.Length>	lookup(String name)
static void	visitGeometry(org.locationtech.jts.geom.Geometry geom, GeometryUtils.GeometryHandler geometryHandler)
static org.locationtech.jts.geom.Geometry	world(org.locationtech.jts.geom.GeometryFactory factory, org.opengis.referencing.crs.CoordinateReferenceSystem crs) Return a multi-polygon representing the bounded map regions split by the axis
static NumericData	xRangeFromGeometry(org.locationtech.jts.geom.Geometry geometry) Generate a longitude range from a JTS geometry
static NumericData	yRangeFromGeometry(org.locationtech.jts.geom.Geometry geometry) Generate a latitude range from a JTS geometry

Methods inherited from class java.lang.Object

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

Field Detail

GEOMETRY_FACTORY

public static final org.locationtech.jts.geom.GeometryFactory GEOMETRY_FACTORY

PREPARED_GEOMETRY_FACTORY

public static final org.locationtech.jts.geom.prep.PreparedGeometryFactory PREPARED_GEOMETRY_FACTORY

DEFAULT_CRS_STR

public static final String DEFAULT_CRS_STR

See Also:

Constant Field Values

MAX_GEOMETRY_PRECISION

public static final Integer MAX_GEOMETRY_PRECISION

Constructor Detail

GeometryUtils

public GeometryUtils()

Method Detail

geometryToSpatialOperator

public static org.opengis.filter.spatial.SpatialOperator geometryToSpatialOperator(org.locationtech.jts.geom.Geometry jtsGeom,
                                                                                   String geometryAttributeName,
                                                                                   org.opengis.referencing.crs.CoordinateReferenceSystem crs)

visitGeometry

public static void visitGeometry(org.locationtech.jts.geom.Geometry geom,
                                 GeometryUtils.GeometryHandler geometryHandler)

decodeCRS

public static org.opengis.referencing.crs.CoordinateReferenceSystem decodeCRS(String crsCode)

getDefaultCRS

public static org.opengis.referencing.crs.CoordinateReferenceSystem getDefaultCRS()

crsMatches

public static boolean crsMatches(String crsCode1,
                                 String crsCode2)

isDefaultCrs

public static boolean isDefaultCrs(String crsCode)

isDefaultCrs

public static boolean isDefaultCrs(org.opengis.referencing.crs.CoordinateReferenceSystem crs)

initClassLoader

public static void initClassLoader()

basicConstraintsFromGeometry

public static BasicQueryByClass.ConstraintsByClass basicConstraintsFromGeometry(org.locationtech.jts.geom.Geometry geometry)

basicGeoConstraintsWrapperFromGeometry

public static GeometryUtils.GeoConstraintsWrapper basicGeoConstraintsWrapperFromGeometry(org.locationtech.jts.geom.Geometry geometry)

This utility method will convert a JTS geometry to contraints that can be used in a GeoWave query.

Returns:

Constraints as a mapping of NumericData objects representing ranges for a latitude dimension and a longitude dimension

basicConstraintSetFromEnvelope

public static BasicQueryByClass.ConstraintSet basicConstraintSetFromEnvelope(org.locationtech.jts.geom.Envelope env)

This utility method will convert a JTS envelope to contraints that can be used in a GeoWave query.

Returns:

Constraints as a mapping of NumericData objects representing ranges for a latitude dimension and a longitude dimension

basicConstraintsFromEnvelope

public static Constraints basicConstraintsFromEnvelope(org.locationtech.jts.geom.Envelope env)

This utility method will convert a JTS envelope to contraints that can be used in a GeoWave query.

Returns:

Constraints as a mapping of NumericData objects representing ranges for a latitude dimension and a longitude dimension

basicConstraintsFromPoint

public static BasicQueryByClass.ConstraintSet basicConstraintsFromPoint(double latitudeDegrees,
                                                                        double longitudeDegrees)

This utility method will convert a JTS envelope to that can be used in a GeoWave query.

Returns:

Constraints as a mapping of NumericData objects representing ranges for a latitude dimension and a longitude dimension

getBoundsFromEnvelope

public static MultiDimensionalNumericData getBoundsFromEnvelope(org.locationtech.jts.geom.Envelope envelope)

xRangeFromGeometry

public static NumericData xRangeFromGeometry(org.locationtech.jts.geom.Geometry geometry)

Generate a longitude range from a JTS geometry

Parameters:

geometry - The JTS geometry

Returns:

The x range

yRangeFromGeometry

public static NumericData yRangeFromGeometry(org.locationtech.jts.geom.Geometry geometry)

Generate a latitude range from a JTS geometry

Parameters:

geometry - The JTS geometry

Returns:

The y range

geometryToBinary

public static byte[] geometryToBinary(org.locationtech.jts.geom.Geometry geometry,
                                      @Nullable
                                      Integer precision)

Converts a JTS geometry to binary using JTS a Well Known Binary writer

Parameters:

geometry - The JTS geometry

Returns:

The binary representation of the geometry

geometryFromBinary

public static org.locationtech.jts.geom.Geometry geometryFromBinary(byte[] binary,
                                                                    @Nullable
                                                                    Integer precision)

Converts a byte array as well-known binary to a JTS geometry

Parameters:

binary - The well known binary

Returns:

The JTS geometry

geometryFromBinary

public static org.locationtech.jts.geom.Geometry geometryFromBinary(byte[] binary,
                                                                    @Nullable
                                                                    Integer precision,
                                                                    byte serializationVersion)

Converts a byte array as well-known binary to a JTS geometry

Parameters:

binary - The well known binary

Returns:

The JTS geometry

infinity

public static org.locationtech.jts.geom.Geometry infinity()

This mehtod returns an envelope between negative infinite and positive inifinity in both x and y

Returns:

the infinite bounding box

getIndexCrs

public static org.opengis.referencing.crs.CoordinateReferenceSystem getIndexCrs(Index[] indices)

getIndexCrs

public static org.opengis.referencing.crs.CoordinateReferenceSystem getIndexCrs(Index index)

getCrsCode

public static String getCrsCode(org.opengis.referencing.crs.CoordinateReferenceSystem crs)

buffer

public static final org.apache.commons.lang3.tuple.Pair<org.locationtech.jts.geom.Geometry,Double> buffer(org.opengis.referencing.crs.CoordinateReferenceSystem crs,
                                                                                                          org.locationtech.jts.geom.Geometry geometry,
                                                                                                          String distanceUnits,
                                                                                                          double distance)
                                                                                                   throws org.opengis.referencing.operation.TransformException

Build a buffer around a geometry

Parameters:

crs -

geometry -

distanceUnits -

distance -

Returns:

the buffered geometry and the degrees that it was buffered

Throws:

org.opengis.referencing.operation.TransformException

lookup

public static javax.measure.Unit<javax.measure.quantity.Length> lookup(String name)

adjustGeo

public static org.locationtech.jts.geom.Geometry adjustGeo(org.opengis.referencing.crs.CoordinateReferenceSystem crs,
                                                           org.locationtech.jts.geom.Geometry geometry)

Consume a geometry that may be over the ranges of the CRS (e.g date-line crossing). Adjust for crossings with a multi-polygon instance where each contained polygon represents a portion of the provided geometry longitude value. Clip hemisphere crossings (fix TBD).

Parameters:

crs -

geometry -

Returns:

the adjusted geometry

fixRangeOfCoordinates

public static List<org.locationtech.jts.geom.Polygon> fixRangeOfCoordinates(org.opengis.referencing.crs.CoordinateReferenceSystem crs,
                                                                            org.locationtech.jts.geom.Geometry geometry)

Adjust geometry so that coordinates fit into long/lat bounds.

Split date-line crossing polygons.

For now, clip hemisphere crossing portions of the polygon.

Parameters:

geometry -

Returns:

list valid polygons

constructGeometriesOverMapRegions

public static List<org.locationtech.jts.geom.Polygon> constructGeometriesOverMapRegions(org.locationtech.jts.geom.Coordinate modifier,
                                                                                        org.locationtech.jts.geom.Geometry geometry)

Produce a set of polygons for each region of the map corrected for date line and hemisphere crossings. Due to the complexity of going around the hemisphere, clip the range.

Consider a polygon that cross both the hemisphere in the north and the date line in the west (-182 92, -182 88, -178 88, -178 92, -182 92). The result is two polygons: (-180 90, -180 88, -178 88, -178 90, -180 90) (180 90, 180 88, 178 88, 178 90, 180 90)

Parameters:

modifier -

geometry - - a geometry that may cross date line and/or hemispheres.

Returns:

the set of polygons

adjustCoordinateToFitInRange

public static org.locationtech.jts.geom.Coordinate adjustCoordinateToFitInRange(org.opengis.referencing.crs.CoordinateReferenceSystem crs,
                                                                                org.locationtech.jts.geom.Coordinate coord)

Make sure the coordinate falls in the range of provided coordinate reference systems's coordinate system. 'x' coordinate is wrapped around date line. 'y' and 'z' coordinate are clipped. At some point, this function will be adjusted to project 'y' appropriately.

Parameters:

crs -

coord -

Returns:

the adjusted coordinate

adjustCoordinateDimensionToRange

public static double adjustCoordinateDimensionToRange(double val,
                                                      org.opengis.referencing.crs.CoordinateReferenceSystem crs,
                                                      int axis)

This is perhaps a brain dead approach to do this, but it does handle wrap around cases. Also supports cases where the wrap around occurs many times.

Parameters:

val - the value

crs -

axis - the coordinate axis

Returns:

the adjusted coordinate dimension

world

public static org.locationtech.jts.geom.Geometry world(org.locationtech.jts.geom.GeometryFactory factory,
                                                       org.opengis.referencing.crs.CoordinateReferenceSystem crs)

Return a multi-polygon representing the bounded map regions split by the axis

Parameters:

factory -

crs -

Returns:

a world geometry

crsTransform

public static org.opengis.feature.simple.SimpleFeature crsTransform(org.opengis.feature.simple.SimpleFeature entry,
                                                                    org.opengis.feature.simple.SimpleFeatureType reprojectedType,
                                                                    org.opengis.referencing.operation.MathTransform transform)

crsTransform

public static org.locationtech.jts.geom.Geometry crsTransform(org.locationtech.jts.geom.Geometry geometry,
                                                              org.opengis.referencing.operation.MathTransform transform)