org.apache.lucene.geo3d

Interface Bounds

All Known Implementing Classes:

LatLonBounds, XYZBounds

public interface Bounds

An interface for accumulating bounds information. The bounds object is initially empty. Bounding points are then applied by supplying (x,y,z) tuples. It is also possible to indicate the following edge cases: (1) No longitude bound possible (2) No upper latitude bound possible (3) No lower latitude bound possible When any of these have been applied, further application of points cannot override that decision.

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

Method Summary

Methods

Modifier and Type	Method and Description
Bounds	addHorizontalPlane(PlanetModel planetModel, double latitude, Plane horizontalPlane, Membership... bounds) Add a horizontal plane to the bounds description.
Bounds	addPlane(PlanetModel planetModel, Plane plane, Membership... bounds) Add a general plane to the bounds description.
Bounds	addPoint(GeoPoint point) Add a single point.
Bounds	addVerticalPlane(PlanetModel planetModel, double longitude, Plane verticalPlane, Membership... bounds) Add a vertical plane to the bounds description.
Bounds	addXValue(GeoPoint point) Add an X value.
Bounds	addYValue(GeoPoint point) Add a Y value.
Bounds	addZValue(GeoPoint point) Add a Z value.
Bounds	isWide() Signal that the shape exceeds Math.PI in longitude.
Bounds	noBottomLatitudeBound() Signal that there is no bottom latitude bound.
Bounds	noLongitudeBound() Signal that there is no longitude bound.
Bounds	noTopLatitudeBound() Signal that there is no top latitude bound.

Method Detail

addPlane

Bounds addPlane(PlanetModel planetModel,
              Plane plane,
              Membership... bounds)

Add a general plane to the bounds description.

Parameters:

planetModel - is the planet model.

plane - is the plane.

bounds - are the membership bounds for points along the arc.

addHorizontalPlane

Bounds addHorizontalPlane(PlanetModel planetModel,
                        double latitude,
                        Plane horizontalPlane,
                        Membership... bounds)

Add a horizontal plane to the bounds description. This method should EITHER use the supplied latitude, OR use the supplied plane, depending on what is most efficient.

Parameters:

planetModel - is the planet model.

latitude - is the latitude.

horizontalPlane - is the plane.

bounds - are the constraints on the plane.

Returns:

updated Bounds object.

addVerticalPlane

Bounds addVerticalPlane(PlanetModel planetModel,
                      double longitude,
                      Plane verticalPlane,
                      Membership... bounds)

Add a vertical plane to the bounds description. This method should EITHER use the supplied longitude, OR use the supplied plane, depending on what is most efficient.

Parameters:

planetModel - is the planet model.

longitude - is the longitude.

verticalPlane - is the plane.

bounds - are the constraints on the plane.

Returns:

updated Bounds object.

addPoint

Bounds addPoint(GeoPoint point)

Add a single point.

Parameters:

point - is the point.

Returns:

the updated Bounds object.

addXValue

Bounds addXValue(GeoPoint point)

Add an X value.

Parameters:

point - is the point to take the x value from.

Returns:

the updated object.

addYValue

Bounds addYValue(GeoPoint point)

Add a Y value.

Parameters:

point - is the point to take the y value from.

Returns:

the updated object.

addZValue

Bounds addZValue(GeoPoint point)

Add a Z value.

Parameters:

point - is the point to take the z value from.

Returns:

the updated object.

isWide

Bounds isWide()

Signal that the shape exceeds Math.PI in longitude.

Returns:

the updated Bounds object.

noLongitudeBound

Bounds noLongitudeBound()

Signal that there is no longitude bound.

Returns:

the updated Bounds object.

noTopLatitudeBound

Bounds noTopLatitudeBound()

Signal that there is no top latitude bound.

Returns:

the updated Bounds object.

noBottomLatitudeBound

Bounds noBottomLatitudeBound()

Signal that there is no bottom latitude bound.

Returns:

the updated Bounds object.