oracle.spatial.hadoop.vector.util

Class SpatialUtils

java.lang.Object

oracle.spatial.hadoop.vector.util.SpatialUtils

public class SpatialUtils
extends java.lang.Object

Provides convenience spatial operations used internally by the API components.

Constructor Summary

Constructors

Constructor and Description
SpatialUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	anyInteract(oracle.spatial.geometry.JGeometry g1, oracle.spatial.geometry.JGeometry g2, java.lang.Boolean geodetic, java.lang.Double tolerance) Performs an anyInteract test between two geometries
static void	compute2DPolygonCentroid(double[] polygonOrdinates, double[] centroid)
static oracle.spatial.geometry.JGeometry	compute2DPolygonCentroid(double[] ordinates, int srid)
static void	createHexagonFromCircle(double cx, double cy, double radius, double[] hexOrds)
static oracle.spatial.geometry.JGeometry	createHexagonFromCircle(double cx, double cy, double radius, int srid)
static SpatialOperationConfig	createSpatialOperationConfig(org.apache.hadoop.mapred.JobConf conf) Deprecated. Use SpatialOperationConfig.load() instead. Creates a SpatialOperationConfig out of the job configuration
static void	expandMbr(double[] mbr, double[] point)
static java.lang.String	geomToString(oracle.spatial.geometry.JGeometry geom)
static void	getCentroid(oracle.spatial.geometry.JGeometry geom, double[] centroid)
static double[]	getIntersectingMBR(double[] mbr1, double[] mbr2)
static double[]	getMBRWithTolerance(oracle.spatial.geometry.JGeometry geom, SpatialConfig spatialConfig)
static void	getPoint(double x, double y, double angle, double length, boolean degrees, double[] point)
static double	getPointDistance(double[] p1, double[] p2, int dim)
static double	getPointDistance(double p1X, double p1Y, double p2X, double p2Y)
static void	getSpanForIndex(oracle.spatial.geometry.JGeometry geom, double[][] span)
static void	getSpanForIndex(oracle.spatial.geometry.JGeometry geom, double[][] span, java.lang.Double tolerance)
static void	getSpanForIndex(oracle.spatial.geometry.JGeometry geom, double[][] span, SpatialConfig spatialConf, boolean addTolerance)
static boolean	isGeodeticSrid(java.lang.Integer srid) Returns true if the current SRID is geodetic
static boolean	isInside(oracle.spatial.geometry.JGeometry g1, oracle.spatial.geometry.JGeometry g2, java.lang.Boolean geodetic, java.lang.Double tolerance) Performs an isInside test between two geometry
static boolean	isValidMBR(double[] mbr)
static boolean	performFilter(oracle.spatial.geometry.JGeometry geom, SpatialOperationConfig spatialOpConf) Performs the spatial operation described by the SpatialOperationConfig parameter.
static oracle.spatial.geometry.FastJGeometry	toFastJGeometry(oracle.spatial.geometry.JGeometry geom, double tol, java.util.EnumSet<SpatialOperation> opSet)
static oracle.spatial.geometry.FastJGeometry	toFastJGeometry(oracle.spatial.geometry.JGeometry geom, double tol, SpatialOperation op)
static oracle.spatial.geometry.JGeometry	toFastJGeometrySafety(oracle.spatial.geometry.JGeometry geom, double tol, SpatialOperation op)
static oracle.spatial.geometry.FastJGeometry.FastOp	toFastOp(SpatialOperation op)
static boolean	withinDistance(oracle.spatial.geometry.JGeometry g1, oracle.spatial.geometry.JGeometry g2, double maxDistance, java.lang.Boolean geodetic, java.lang.Double tolerance)

Methods inherited from class java.lang.Object

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

Constructor Detail

SpatialUtils

public SpatialUtils()

Method Detail

createSpatialOperationConfig

public static SpatialOperationConfig createSpatialOperationConfig(org.apache.hadoop.mapred.JobConf conf)

Deprecated. Use SpatialOperationConfig.load() instead. Creates a SpatialOperationConfig out of the job configuration

Parameters:

conf - the job configuration

Returns:

a SpatialOperation

performFilter

public static boolean performFilter(oracle.spatial.geometry.JGeometry geom,
                                    SpatialOperationConfig spatialOpConf)
                             throws java.lang.Exception

Performs the spatial operation described by the SpatialOperationConfig parameter.

Parameters:

geom - a JGeometry instance that will be used as operand in the spatal filter

spatialOpConf - a SpatialOperationConfig which describes the operation to perform

Returns:

true if the spatial operation succeeded

Throws:

java.lang.Exception

isInside

public static boolean isInside(oracle.spatial.geometry.JGeometry g1,
                               oracle.spatial.geometry.JGeometry g2,
                               java.lang.Boolean geodetic,
                               java.lang.Double tolerance)
                        throws java.lang.Exception

Performs an isInside test between two geometry

Parameters:

g1 - the geometry which is tested to be within the other

g2 - the geometry which may contain the first geometry

geodetic - whether the geometries are geodetic or not

tolerance - the tolerance used

Returns:

true if g1 is whithin g2

Throws:

java.lang.Exception

anyInteract

public static boolean anyInteract(oracle.spatial.geometry.JGeometry g1,
                                  oracle.spatial.geometry.JGeometry g2,
                                  java.lang.Boolean geodetic,
                                  java.lang.Double tolerance)
                           throws java.lang.Exception

Performs an anyInteract test between two geometries

Parameters:

g1 - a JGeometry instance

g2 - a JGeometry instance

geodetic - whether the geometries are geodetic or not

tolerance - the tolerance used

Returns:

true if the geometries interact

Throws:

java.lang.Exception

withinDistance

public static boolean withinDistance(oracle.spatial.geometry.JGeometry g1,
                                     oracle.spatial.geometry.JGeometry g2,
                                     double maxDistance,
                                     java.lang.Boolean geodetic,
                                     java.lang.Double tolerance)
                              throws java.lang.Exception

Throws:

java.lang.Exception

geomToString

public static java.lang.String geomToString(oracle.spatial.geometry.JGeometry geom)

getPointDistance

public static double getPointDistance(double[] p1,
                                      double[] p2,
                                      int dim)

getPointDistance

public static double getPointDistance(double p1X,
                                      double p1Y,
                                      double p2X,
                                      double p2Y)

getCentroid

public static void getCentroid(oracle.spatial.geometry.JGeometry geom,
                               double[] centroid)

createHexagonFromCircle

public static oracle.spatial.geometry.JGeometry createHexagonFromCircle(double cx,
                                                                        double cy,
                                                                        double radius,
                                                                        int srid)

createHexagonFromCircle

public static void createHexagonFromCircle(double cx,
                                           double cy,
                                           double radius,
                                           double[] hexOrds)

getPoint

public static void getPoint(double x,
                            double y,
                            double angle,
                            double length,
                            boolean degrees,
                            double[] point)

getMBRWithTolerance

public static double[] getMBRWithTolerance(oracle.spatial.geometry.JGeometry geom,
                                           SpatialConfig spatialConfig)

getSpanForIndex

public static void getSpanForIndex(oracle.spatial.geometry.JGeometry geom,
                                   double[][] span)

getSpanForIndex

public static void getSpanForIndex(oracle.spatial.geometry.JGeometry geom,
                                   double[][] span,
                                   SpatialConfig spatialConf,
                                   boolean addTolerance)

getSpanForIndex

public static void getSpanForIndex(oracle.spatial.geometry.JGeometry geom,
                                   double[][] span,
                                   java.lang.Double tolerance)

compute2DPolygonCentroid

public static void compute2DPolygonCentroid(double[] polygonOrdinates,
                                            double[] centroid)

compute2DPolygonCentroid

public static oracle.spatial.geometry.JGeometry compute2DPolygonCentroid(double[] ordinates,
                                                                         int srid)

isValidMBR

public static boolean isValidMBR(double[] mbr)

expandMbr

public static void expandMbr(double[] mbr,
                             double[] point)

isGeodeticSrid

public static boolean isGeodeticSrid(java.lang.Integer srid)

Returns true if the current SRID is geodetic

Returns:

getIntersectingMBR

public static double[] getIntersectingMBR(double[] mbr1,
                                          double[] mbr2)

toFastOp

public static oracle.spatial.geometry.FastJGeometry.FastOp toFastOp(SpatialOperation op)

toFastJGeometry

public static oracle.spatial.geometry.FastJGeometry toFastJGeometry(oracle.spatial.geometry.JGeometry geom,
                                                                    double tol,
                                                                    SpatialOperation op)
                                                             throws java.lang.Exception

Throws:

java.lang.Exception

toFastJGeometrySafety

public static oracle.spatial.geometry.JGeometry toFastJGeometrySafety(oracle.spatial.geometry.JGeometry geom,
                                                                      double tol,
                                                                      SpatialOperation op)

toFastJGeometry

public static oracle.spatial.geometry.FastJGeometry toFastJGeometry(oracle.spatial.geometry.JGeometry geom,
                                                                    double tol,
                                                                    java.util.EnumSet<SpatialOperation> opSet)
                                                             throws java.lang.Exception

Throws:

java.lang.Exception