org.apache.lucene.geo3d

Class SidedPlane

java.lang.Object

org.apache.lucene.geo3d.Vector

org.apache.lucene.geo3d.Plane

org.apache.lucene.geo3d.SidedPlane

All Implemented Interfaces:

Membership

public class SidedPlane
extends Plane
implements Membership

Combination of a plane, and a sign value indicating what evaluation values are on the correct side of the plane.

WARNING: This API is experimental and might change in incompatible ways in the next release.

Field Summary

Fields

Modifier and Type	Field and Description
double	sigNum The sign value for evaluation of a point on the correct side of the plane

Fields inherited from class org.apache.lucene.geo3d.Plane

D, NO_BOUNDS, NO_POINTS, normalXPlane, normalYPlane, normalZPlane

Fields inherited from class org.apache.lucene.geo3d.Vector

MINIMUM_RESOLUTION, MINIMUM_RESOLUTION_CUBED, MINIMUM_RESOLUTION_SQUARED, x, y, z

Constructor Summary

Constructors

Constructor and Description
SidedPlane(double pX, double pY, double pZ, Vector v, double D) Construct a sided plane with a normal vector and offset.
SidedPlane(SidedPlane sidedPlane) Construct a SidedPlane identical to an existing one, but reversed.
SidedPlane(Vector p, double x, double y) Construct a sided vertical plane from a point and specified x and y coordinates.
SidedPlane(Vector p, PlanetModel planetModel, double sinLat) Construct a sided plane from a point and a Z coordinate.
SidedPlane(Vector p, Vector v, double D) Construct a sided plane with a normal vector and offset.
SidedPlane(Vector p, Vector A, Vector B) Construct a sided plane from a pair of vectors describing points, and including origin, plus a point p which describes the side.

Method Summary

Methods

Modifier and Type	Method and Description
static SidedPlane	constructNormalizedPerpendicularSidedPlane(Vector insidePoint, Vector normalVector, Vector point1, Vector point2) Construct a sided plane from two points and a third normal vector.
static SidedPlane	constructNormalizedThreePointSidedPlane(Vector insidePoint, Vector point1, Vector point2, Vector point3) Construct a sided plane from three points.
boolean	equals(Object o)
int	hashCode()
boolean	isWithin(double x, double y, double z) Check if a point is within this shape.
boolean	isWithin(Vector point) Check if a point is within this shape.
String	toString()

Methods inherited from class org.apache.lucene.geo3d.Plane

addPoint, arcDistance, arcDistance, constructNormalizedXPlane, constructNormalizedXPlane, constructNormalizedYPlane, constructNormalizedYPlane, constructNormalizedZPlane, constructNormalizedZPlane, evaluate, evaluate, evaluateIsZero, evaluateIsZero, findIntersections, findIntersections, getSampleIntersectionPoint, interpolate, intersects, isNumericallyIdentical, linearDistance, linearDistance, linearDistanceSquared, linearDistanceSquared, meetsAllBounds, meetsAllBounds, meetsAllBounds, meetsAllBounds, modify, normalDistance, normalDistance, normalDistanceSquared, normalDistanceSquared, normalize, recordBounds, recordBounds, reverseModify

Methods inherited from class org.apache.lucene.geo3d.Vector

computeDesiredEllipsoidMagnitude, computeDesiredEllipsoidMagnitude, dotProduct, dotProduct, isWithin, linearDistance, linearDistance, linearDistanceSquared, linearDistanceSquared, magnitude, magnitude, normalDistance, normalDistance, normalDistanceSquared, normalDistanceSquared, rotateXY, rotateXY, rotateXZ, rotateXZ, rotateZY, rotateZY, translate

Methods inherited from class java.lang.Object

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

Field Detail

sigNum

public final double sigNum

The sign value for evaluation of a point on the correct side of the plane

Constructor Detail

SidedPlane

public SidedPlane(SidedPlane sidedPlane)

Construct a SidedPlane identical to an existing one, but reversed.

Parameters:

sidedPlane - is the existing plane.

SidedPlane

public SidedPlane(Vector p,
          Vector A,
          Vector B)

Construct a sided plane from a pair of vectors describing points, and including origin, plus a point p which describes the side.

Parameters:

p - point to evaluate

A - is the first in-plane point

B - is the second in-plane point

SidedPlane

public SidedPlane(Vector p,
          PlanetModel planetModel,
          double sinLat)

Construct a sided plane from a point and a Z coordinate.

Parameters:

p - point to evaluate.

planetModel - is the planet model.

sinLat - is the sin of the latitude of the plane.

SidedPlane

public SidedPlane(Vector p,
          double x,
          double y)

Construct a sided vertical plane from a point and specified x and y coordinates.

Parameters:

p - point to evaluate.

x - is the specified x.

y - is the specified y.

SidedPlane

public SidedPlane(Vector p,
          Vector v,
          double D)

Construct a sided plane with a normal vector and offset.

Parameters:

p - point to evaluate.

v - is the normal vector.

D - is the origin offset for the plan.

SidedPlane

public SidedPlane(double pX,
          double pY,
          double pZ,
          Vector v,
          double D)

Construct a sided plane with a normal vector and offset.

Parameters:

pX - X coord of point to evaluate.

pY - Y coord of point to evaluate.

pZ - Z coord of point to evaluate.

v - is the normal vector.

D - is the origin offset for the plan.

Method Detail

constructNormalizedPerpendicularSidedPlane

public static SidedPlane constructNormalizedPerpendicularSidedPlane(Vector insidePoint,
                                                    Vector normalVector,
                                                    Vector point1,
                                                    Vector point2)

Construct a sided plane from two points and a third normal vector.

constructNormalizedThreePointSidedPlane

public static SidedPlane constructNormalizedThreePointSidedPlane(Vector insidePoint,
                                                 Vector point1,
                                                 Vector point2,
                                                 Vector point3)

Construct a sided plane from three points.

isWithin

public boolean isWithin(Vector point)

Description copied from interface: Membership

Check if a point is within this shape.

Specified by:

isWithin in interface Membership

Parameters:

point - is the point to check.

Returns:

true if the point is within this shape

isWithin

public boolean isWithin(double x,
               double y,
               double z)

Description copied from interface: Membership

Check if a point is within this shape.

Specified by:

isWithin in interface Membership

Parameters:

x - is x coordinate of point to check.

y - is y coordinate of point to check.

z - is z coordinate of point to check.

Returns:

true if the point is within this shape

equals

public boolean equals(Object o)

Overrides:

equals in class Plane

hashCode

public int hashCode()

Overrides:

hashCode in class Plane

toString

public String toString()

Overrides:

toString in class Plane