prajna.geo

Class GeoBearing

java.lang.Object

prajna.geo.GeoPolyline

prajna.geo.GeoBearing

All Implemented Interfaces:

java.awt.Shape, java.io.Serializable, Locatable, GeoShape

public class GeoBearing
extends GeoPolyline

Geographic representation of a line of bearing. A line of bearing is a curve on the surface of the earth which follows the path of a great circle. Therefore, the line of bearing represents the shortest path from one coordinate to another.

Author:

Edward Swing

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GeoBearing(GeoCoord start, double angle, double length) Create a new GeoBearing from the specified start point with the specified azimuth and length.
GeoBearing(GeoCoord start, double angle, double length, double increment) Create a new GeoBearing from the specified start point with the specified azimuth and length.

Method Summary

Methods

Modifier and Type	Method and Description
double	getAzimuth() Gets the azimuth for this line of bearing.
double	getLength() Get the bearing length
GeoCoord	getStartCoord() Get the coordinate of the start of the line of bearing

Methods inherited from class prajna.geo.GeoPolyline

contains, contains, contains, contains, getBounds, getBounds2D, getCenter, getCoordinates, getData, getGeoBounds, getGeoPoints, getPathIterator, getPathIterator, getRadius, getRenderStyle, intersects, intersects, project, setData, setGeoPoints, setRenderStyle, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoBearing

public GeoBearing(GeoCoord start,
          double angle,
          double length)

Create a new GeoBearing from the specified start point with the specified azimuth and length. The azimuth angle is measured in radians from true north. The length is also measured in radians. This constructor uses a default increment equal to 1/20 of the total length of the line of bearing.

Parameters:

start - the starting coordinate for the line of bearing

angle - the azimuth angle, measured in degrees, from true north

length - the length of the line of bearing, measured in meters

GeoBearing

public GeoBearing(GeoCoord start,
          double angle,
          double length,
          double increment)

Create a new GeoBearing from the specified start point with the specified azimuth and length. The azimuth angle is measured in degrees from true north. The length and increment are measured in meters.

Parameters:

start - the starting coordinate for the line of bearing

angle - the azimuth angle, measured in degrees, from true north

length - the length of the line of bearing, measured in meters

increment - the increment interval to use along the line of bearing. This number should be a small fraction of the length.

Method Detail

getAzimuth

public double getAzimuth()

Gets the azimuth for this line of bearing. The bearing is measured from true north in a clockwise direction, and specified in degrees.

Returns:

the azimuth, measured in degrees from true north, for this bearing

getLength

public double getLength()

Get the bearing length

Returns:

the length of the bearing arc, in meters

getStartCoord

public GeoCoord getStartCoord()

Get the coordinate of the start of the line of bearing

Returns:

the coordinate for the bearing starting point