Package org.apache.lucene.spatial3d.geom

Class LatLonBounds

java.lang.Object

org.apache.lucene.spatial3d.geom.LatLonBounds

All Implemented Interfaces:

Bounds

public class LatLonBounds
extends java.lang.Object
implements Bounds

An object for accumulating latitude/longitude bounds information.

Field Summary

Fields

Modifier and Type	Field	Description
private java.lang.Double	leftLongitude	If non-null, the left longitude bound
private java.lang.Double	maxLatitude	If non-null, the maximum latitude bound
private java.lang.Double	minLatitude	If non-null, the minimum latitude bound
private boolean	noBottomLatitudeBound	Set to true if no bottom latitude bound can be stated
private boolean	noLongitudeBound	Set to true if no longitude bounds can be stated
private boolean	noTopLatitudeBound	Set to true if no top latitude bound can be stated
private java.lang.Double	rightLongitude	If non-null, the right longitude bound

Constructor Summary

Constructors

Constructor	Description
LatLonBounds()	Construct an empty bounds object

Method Summary

Modifier and Type	Method	Description
Bounds	addHorizontalPlane(PlanetModel planetModel, double latitude, Plane horizontalPlane, Membership... bounds)	Add a horizontal plane to the bounds description.
Bounds	addIntersection(PlanetModel planetModel, Plane plane1, Plane plane2, Membership... bounds)	Add the intersection between two planes to the bounds description.
private void	addLatitudeBound(double latitude)	Update latitude bound.
private void	addLongitudeBound(double longitude)	Update longitude bound.
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.
boolean	checkNoBottomLatitudeBound()	Check if there's no bottom latitude bound.
boolean	checkNoLongitudeBound()	Check if there's no longitude bound.
boolean	checkNoTopLatitudeBound()	Check if there's no top latitude bound.
java.lang.Double	getLeftLongitude()	Get left longitude, if any.
java.lang.Double	getMaxLatitude()	Get maximum latitude, if any.
java.lang.Double	getMinLatitude()	Get minimum latitude, if any.
java.lang.Double	getRightLongitude()	Get right longitude, if any.
Bounds	isWide()	Signal that the shape exceeds Math.PI in longitude.
Bounds	noBottomLatitudeBound()	Signal that there is no bottom latitude bound.
Bounds	noBound(PlanetModel planetModel)	Signal that there is no bound whatsoever.
Bounds	noLongitudeBound()	Signal that there is no longitude bound.
Bounds	noTopLatitudeBound()	Signal that there is no top latitude bound.

Methods inherited from class java.lang.Object

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

Field Detail

noLongitudeBound

private boolean noLongitudeBound

Set to true if no longitude bounds can be stated

noTopLatitudeBound

private boolean noTopLatitudeBound

Set to true if no top latitude bound can be stated

noBottomLatitudeBound

private boolean noBottomLatitudeBound

Set to true if no bottom latitude bound can be stated

minLatitude

private java.lang.Double minLatitude

If non-null, the minimum latitude bound

maxLatitude

private java.lang.Double maxLatitude

If non-null, the maximum latitude bound

leftLongitude

private java.lang.Double leftLongitude

If non-null, the left longitude bound

rightLongitude

private java.lang.Double rightLongitude

If non-null, the right longitude bound

Constructor Detail

LatLonBounds

public LatLonBounds()

Construct an empty bounds object

Method Detail

getMaxLatitude

public java.lang.Double getMaxLatitude()

Get maximum latitude, if any.

Returns:

maximum latitude or null.

getMinLatitude

public java.lang.Double getMinLatitude()

Get minimum latitude, if any.

Returns:

minimum latitude or null.

getLeftLongitude

public java.lang.Double getLeftLongitude()

Get left longitude, if any.

Returns:

left longitude, or null.

getRightLongitude

public java.lang.Double getRightLongitude()

Get right longitude, if any.

Returns:

right longitude, or null.

checkNoLongitudeBound

public boolean checkNoLongitudeBound()

Check if there's no longitude bound.

Returns:

true if no longitude bound.

checkNoTopLatitudeBound

public boolean checkNoTopLatitudeBound()

Check if there's no top latitude bound.

Returns:

true if no top latitude bound.

checkNoBottomLatitudeBound

public boolean checkNoBottomLatitudeBound()

Check if there's no bottom latitude bound.

Returns:

true if no bottom latitude bound.

addPlane

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

Description copied from interface: Bounds

Add a general plane to the bounds description.

Specified by:

addPlane in interface Bounds

Parameters:

planetModel - is the planet model.

plane - is the plane.

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

addHorizontalPlane

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

Description copied from interface: 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.

Specified by:

addHorizontalPlane in interface Bounds

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

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

Description copied from interface: 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.

Specified by:

addVerticalPlane in interface Bounds

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.

isWide

public Bounds isWide()

Description copied from interface: Bounds

Signal that the shape exceeds Math.PI in longitude.

Specified by:

isWide in interface Bounds

Returns:

the updated Bounds object.

addXValue

public Bounds addXValue(GeoPoint point)

Description copied from interface: Bounds

Add an X value.

Specified by:

addXValue in interface Bounds

Parameters:

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

Returns:

the updated object.

addYValue

public Bounds addYValue(GeoPoint point)

Description copied from interface: Bounds

Add a Y value.

Specified by:

addYValue in interface Bounds

Parameters:

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

Returns:

the updated object.

addZValue

public Bounds addZValue(GeoPoint point)

Description copied from interface: Bounds

Add a Z value.

Specified by:

addZValue in interface Bounds

Parameters:

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

Returns:

the updated object.

addIntersection

public Bounds addIntersection(PlanetModel planetModel,
                              Plane plane1,
                              Plane plane2,
                              Membership... bounds)

Description copied from interface: Bounds

Add the intersection between two planes to the bounds description. Where the shape has intersecting planes, it is better to use this method than just adding the point, since this method takes each plane's error envelope into account.

Specified by:

addIntersection in interface Bounds

Parameters:

planetModel - is the planet model.

plane1 - is the first plane.

plane2 - is the second plane.

bounds - are the membership bounds for the intersection.

addPoint

public Bounds addPoint(GeoPoint point)

Description copied from interface: Bounds

Add a single point.

Specified by:

addPoint in interface Bounds

Parameters:

point - is the point.

Returns:

the updated Bounds object.

noLongitudeBound

public Bounds noLongitudeBound()

Description copied from interface: Bounds

Signal that there is no longitude bound.

Specified by:

noLongitudeBound in interface Bounds

Returns:

the updated Bounds object.

noTopLatitudeBound

public Bounds noTopLatitudeBound()

Description copied from interface: Bounds

Signal that there is no top latitude bound.

Specified by:

noTopLatitudeBound in interface Bounds

Returns:

the updated Bounds object.

noBottomLatitudeBound

public Bounds noBottomLatitudeBound()

Description copied from interface: Bounds

Signal that there is no bottom latitude bound.

Specified by:

noBottomLatitudeBound in interface Bounds

Returns:

the updated Bounds object.

noBound

public Bounds noBound(PlanetModel planetModel)

Description copied from interface: Bounds

Signal that there is no bound whatsoever. The bound is limited only by the constraints of the planet.

Specified by:

noBound in interface Bounds

Returns:

the updated Bounds object.,

addLatitudeBound

private void addLatitudeBound(double latitude)

Update latitude bound.

Parameters:

latitude - is the latitude.

addLongitudeBound

private void addLongitudeBound(double longitude)

Update longitude bound.

Parameters:

longitude - is the new longitude value.