com.spatial4j.core.distance

Class CartesianDistCalc

java.lang.Object

com.spatial4j.core.distance.AbstractDistanceCalculator

com.spatial4j.core.distance.CartesianDistCalc

All Implemented Interfaces:

DistanceCalculator

public class CartesianDistCalc
extends AbstractDistanceCalculator

Calculates based on Euclidean / Cartesian 2d plane.

Constructor Summary

Constructors

Constructor and Description
CartesianDistCalc()
CartesianDistCalc(boolean squared)

Method Summary

Modifier and Type	Method and Description
double	area(Circle circle)
double	area(Rectangle rect)
double	calcBoxByDistFromPt_yHorizAxisDEG(Point from, double distDEG, SpatialContext ctx) The Y coordinate of the horizontal axis of a circle that has maximum width.
Rectangle	calcBoxByDistFromPt(Point from, double distDEG, SpatialContext ctx, Rectangle reuse) Calculates the bounding box of a circle, as specified by its center point and distance.
double	distance(Point from, double toX, double toY) The distance between from and Point(toX,toY).
boolean	equals(Object o)
int	hashCode()
Point	pointOnBearing(Point from, double distDEG, double bearingDEG, SpatialContext ctx, Point reuse) Calculates where a destination point is given an origin (from) distance, and bearing (given in degrees -- 0-360).
boolean	within(Point from, double toX, double toY, double distance) Returns true if the distance between from and to is <= distance.

Methods inherited from class com.spatial4j.core.distance.AbstractDistanceCalculator

distance, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

CartesianDistCalc

public CartesianDistCalc()

CartesianDistCalc

public CartesianDistCalc(boolean squared)

Parameters:

squared - Set to true to have AbstractDistanceCalculator.distance(com.spatial4j.core.shape.Point, com.spatial4j.core.shape.Point) return the square of the correct answer. This is a performance optimization used when sorting in which the actual distance doesn't matter so long as the sort order is consistent.

Method Detail

distance

public double distance(Point from,
                       double toX,
                       double toY)

Description copied from interface: DistanceCalculator

The distance between from and Point(toX,toY).

within

public boolean within(Point from,
                      double toX,
                      double toY,
                      double distance)

Description copied from interface: DistanceCalculator

Returns true if the distance between from and to is <= distance.

Specified by:

within in interface DistanceCalculator

Overrides:

within in class AbstractDistanceCalculator

pointOnBearing

public Point pointOnBearing(Point from,
                            double distDEG,
                            double bearingDEG,
                            SpatialContext ctx,
                            Point reuse)

Description copied from interface: DistanceCalculator

Calculates where a destination point is given an origin (from) distance, and bearing (given in degrees -- 0-360). If reuse is given, then this method may reset() it and return it.

calcBoxByDistFromPt

public Rectangle calcBoxByDistFromPt(Point from,
                                     double distDEG,
                                     SpatialContext ctx,
                                     Rectangle reuse)

Description copied from interface: DistanceCalculator

Calculates the bounding box of a circle, as specified by its center point and distance.

calcBoxByDistFromPt_yHorizAxisDEG

public double calcBoxByDistFromPt_yHorizAxisDEG(Point from,
                                                double distDEG,
                                                SpatialContext ctx)

Description copied from interface: DistanceCalculator

The Y coordinate of the horizontal axis of a circle that has maximum width. On a 2D plane, this result is always from.getY() but, perhaps surprisingly, on a sphere it is going to be slightly different.

area

public double area(Rectangle rect)

area

public double area(Circle circle)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object