com.moximedia.aims.projection
Class Ellipsoid

java.lang.Object
  com.moximedia.aims.projection.Ellipsoid

All Implemented Interfaces:

java.lang.Cloneable, MeasureUnitsType, java.io.Serializable

public class Ellipsoid

extends java.lang.Object

implements MeasureUnitsType, java.lang.Cloneable, java.io.Serializable

See Also:

Serialized Form

Field Summary

static Ellipsoid	ELLIPSOID_AIRY_1830
static Ellipsoid	ELLIPSOID_AIRY_MODIFIED_1849
static Ellipsoid	ELLIPSOID_AUSTRALIAN_NATIONAL_SPHEROID
static Ellipsoid	ELLIPSOID_AVERAGE_TERRESTRIAL_SYSTEM_1977
static Ellipsoid	ELLIPSOID_BESSEL_1841
static Ellipsoid	ELLIPSOID_BESSEL_MODIFIED
static Ellipsoid	ELLIPSOID_BESSEL_NAMIBIA
static Ellipsoid	ELLIPSOID_CLARKE_1866
static Ellipsoid	ELLIPSOID_CLARKE_1880_ARC
static Ellipsoid	ELLIPSOID_CLARKE_1880_BENOIT
static Ellipsoid	ELLIPSOID_CLARKE_1880_IGN
static Ellipsoid	ELLIPSOID_CLARKE_1880_RGS
static Ellipsoid	ELLIPSOID_CLARKE_1880_SGA_1922
static Ellipsoid	ELLIPSOID_EVEREST_1830_1937_ADJUSTMENT
static Ellipsoid	ELLIPSOID_EVEREST_1830_1962_DEFINITION
static Ellipsoid	ELLIPSOID_EVEREST_1830_1967_DEFINITION
static Ellipsoid	ELLIPSOID_EVEREST_1830_1975_DEFINITION
static Ellipsoid	ELLIPSOID_EVEREST_1830_MODIFIED
static Ellipsoid	ELLIPSOID_GEM_10C
static Ellipsoid	ELLIPSOID_GRS_1967
static Ellipsoid	ELLIPSOID_GRS_1980
static Ellipsoid	ELLIPSOID_HELMERT_1906
static Ellipsoid	ELLIPSOID_INDONESIAN_NATIONAL_SPHEROID
static Ellipsoid	ELLIPSOID_INTERNATIONAL_1924
static Ellipsoid	ELLIPSOID_KRASSOWSKY_1940
static Ellipsoid	ELLIPSOID_NWL_9D
static Ellipsoid	ELLIPSOID_OSU86F
static Ellipsoid	ELLIPSOID_OSU91A
static Ellipsoid	ELLIPSOID_PLESSIS_1817
static Ellipsoid	ELLIPSOID_STRUVE_1860
static Ellipsoid	ELLIPSOID_WAR_OFFICE
static Ellipsoid	ELLIPSOID_WGS_72
static Ellipsoid	ELLIPSOID_WGS_84
static Ellipsoid	ELLIPSOID_XIAN_1980

Fields inherited from interface com.moximedia.aims.types.MeasureUnitsType

MEASURE_UNITS_DECIMAL_DEGREES, MEASURE_UNITS_FEET, MEASURE_UNITS_IMPERIAL, MEASURE_UNITS_METERS, MEASURE_UNITS_METRES, MEASURE_UNITS_METRIC, MEASURE_UNITS_UNKNOWN, MEASURE_UNITS_US, MEASURE_UNITS_YARDS

Constructor Summary

Ellipsoid()

Ellipsoid(java.lang.String name, double semiMajorAxis, double inverseFlattening, int units)

Method Summary

java.lang.Object	clone()
boolean	equals(Ellipsoid anotherEllipsoid)
Ellipsoid	getCopy()
double	getCourse(AimsPoint pt1, AimsPoint pt2) Returns the distance between two geographic points.
double	getCourse(double lat1, double lon1, double lat2, double lon2) Returns the distance between two geographic points.
double	getDistance(AimsPoint pt1, AimsPoint pt2) Returns the distance between two geographic points.
double	getDistance(double lat1, double lon1, double lat2, double lon2) Returns the distance between two geographic points.
double[]	getDistanceAndCourse(AimsPoint pt1, AimsPoint pt2) Returns an array containin distance, course, and return course between two geographic points.
double[]	getDistanceAndCourse(double lat1, double lon1, double lat2, double lon2) Returns an array containin distance, course, and return course between two geographic points.
double	getEccentricity()
static Ellipsoid	getEllipsoid(java.lang.String name)
double	getInverseFlattening()
java.lang.String	getName()
AimsPoint	getPosition(AimsPoint fromPt, double distance, double bearing) Returns a point position calculated at the specified distance and bearing from the specified geographic point.
double[]	getPosition(double lat, double lon, double distance, double bearing) Returns an array containing the latitude and longitude of the position calculated at the specified distance and bearing from the specified geographic point.
double	getSemiMajorAxis()
double	getSemiMinorAxis()
int	getUnits()

Methods inherited from class java.lang.Object

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

Field Detail

ELLIPSOID_AIRY_1830

public static final Ellipsoid ELLIPSOID_AIRY_1830

ELLIPSOID_AIRY_MODIFIED_1849

public static final Ellipsoid ELLIPSOID_AIRY_MODIFIED_1849

ELLIPSOID_AUSTRALIAN_NATIONAL_SPHEROID

public static final Ellipsoid ELLIPSOID_AUSTRALIAN_NATIONAL_SPHEROID

ELLIPSOID_BESSEL_1841

public static final Ellipsoid ELLIPSOID_BESSEL_1841

ELLIPSOID_BESSEL_MODIFIED

public static final Ellipsoid ELLIPSOID_BESSEL_MODIFIED

ELLIPSOID_BESSEL_NAMIBIA

public static final Ellipsoid ELLIPSOID_BESSEL_NAMIBIA

ELLIPSOID_CLARKE_1866

public static final Ellipsoid ELLIPSOID_CLARKE_1866

ELLIPSOID_CLARKE_1880_BENOIT

public static final Ellipsoid ELLIPSOID_CLARKE_1880_BENOIT

ELLIPSOID_CLARKE_1880_IGN

public static final Ellipsoid ELLIPSOID_CLARKE_1880_IGN

ELLIPSOID_CLARKE_1880_RGS

public static final Ellipsoid ELLIPSOID_CLARKE_1880_RGS

ELLIPSOID_CLARKE_1880_ARC

public static final Ellipsoid ELLIPSOID_CLARKE_1880_ARC

ELLIPSOID_CLARKE_1880_SGA_1922

public static final Ellipsoid ELLIPSOID_CLARKE_1880_SGA_1922

ELLIPSOID_EVEREST_1830_1937_ADJUSTMENT

public static final Ellipsoid ELLIPSOID_EVEREST_1830_1937_ADJUSTMENT

ELLIPSOID_EVEREST_1830_1967_DEFINITION

public static final Ellipsoid ELLIPSOID_EVEREST_1830_1967_DEFINITION

ELLIPSOID_EVEREST_1830_MODIFIED

public static final Ellipsoid ELLIPSOID_EVEREST_1830_MODIFIED

ELLIPSOID_GRS_1980

public static final Ellipsoid ELLIPSOID_GRS_1980

ELLIPSOID_HELMERT_1906

public static final Ellipsoid ELLIPSOID_HELMERT_1906

ELLIPSOID_INDONESIAN_NATIONAL_SPHEROID

public static final Ellipsoid ELLIPSOID_INDONESIAN_NATIONAL_SPHEROID

ELLIPSOID_INTERNATIONAL_1924

public static final Ellipsoid ELLIPSOID_INTERNATIONAL_1924

ELLIPSOID_KRASSOWSKY_1940

public static final Ellipsoid ELLIPSOID_KRASSOWSKY_1940

ELLIPSOID_NWL_9D

public static final Ellipsoid ELLIPSOID_NWL_9D

ELLIPSOID_PLESSIS_1817

public static final Ellipsoid ELLIPSOID_PLESSIS_1817

ELLIPSOID_STRUVE_1860

public static final Ellipsoid ELLIPSOID_STRUVE_1860

ELLIPSOID_WAR_OFFICE

public static final Ellipsoid ELLIPSOID_WAR_OFFICE

ELLIPSOID_WGS_84

public static final Ellipsoid ELLIPSOID_WGS_84

ELLIPSOID_GEM_10C

public static final Ellipsoid ELLIPSOID_GEM_10C

ELLIPSOID_OSU86F

public static final Ellipsoid ELLIPSOID_OSU86F

ELLIPSOID_OSU91A

public static final Ellipsoid ELLIPSOID_OSU91A

ELLIPSOID_GRS_1967

public static final Ellipsoid ELLIPSOID_GRS_1967

ELLIPSOID_AVERAGE_TERRESTRIAL_SYSTEM_1977

public static final Ellipsoid ELLIPSOID_AVERAGE_TERRESTRIAL_SYSTEM_1977

ELLIPSOID_WGS_72

public static final Ellipsoid ELLIPSOID_WGS_72

ELLIPSOID_EVEREST_1830_1962_DEFINITION

public static final Ellipsoid ELLIPSOID_EVEREST_1830_1962_DEFINITION

ELLIPSOID_EVEREST_1830_1975_DEFINITION

public static final Ellipsoid ELLIPSOID_EVEREST_1830_1975_DEFINITION

ELLIPSOID_XIAN_1980

public static final Ellipsoid ELLIPSOID_XIAN_1980

Constructor Detail

Ellipsoid

public Ellipsoid()

Ellipsoid

public Ellipsoid(java.lang.String name,
                 double semiMajorAxis,
                 double inverseFlattening,
                 int units)

Method Detail

clone

public java.lang.Object clone()

getCopy

public Ellipsoid getCopy()

getName

public java.lang.String getName()

getPosition

public AimsPoint getPosition(AimsPoint fromPt,
                             double distance,
                             double bearing)

Returns a point position calculated at the specified distance and bearing from the specified geographic point.

Parameters:

fromPt - An AimsPoint object containing geographic coordinates. Note that degrees west should be negative.

distance - The offset distance, in kilometres.

bearing - The course bearing, in degrees.

Returns:

The calculated position, as an AimsPoint object.

getPosition

public double[] getPosition(double lat,
                            double lon,
                            double distance,
                            double bearing)

Returns an array containing the latitude and longitude of the position calculated at the specified distance and bearing from the specified geographic point.

Parameters:

lat - The latitude of the origin point.

lon - The longitude of the origin point. Degrees west should be negative.

distance - The offset distance, in metres.

bearing - The course bearing, in degrees.

Returns:

An array containing:
element[0]: The latitude of the calculated position.
element[1]: The longitude of the calculated position.

equals

public boolean equals(Ellipsoid anotherEllipsoid)

getEllipsoid

public static final Ellipsoid getEllipsoid(java.lang.String name)

getEccentricity

public double getEccentricity()

getInverseFlattening

public double getInverseFlattening()

getSemiMajorAxis

public double getSemiMajorAxis()

getSemiMinorAxis

public double getSemiMinorAxis()

getUnits

public int getUnits()

getDistance

public double getDistance(double lat1,
                          double lon1,
                          double lat2,
                          double lon2)

Returns the distance between two geographic points.

Parameters:

lat1 - The latitude of the first point.

lon1 - The longitude of the first point. Degrees west should be negative.

lat2 - The latitude of the second point.

lon2 - The longitude of the second point. Degrees west should be negative.

Returns:

The distance from the first point to the second, in metres.

getDistance

public double getDistance(AimsPoint pt1,
                          AimsPoint pt2)

Returns the distance between two geographic points.

Parameters:

pt1 - The first position.

pt2 - The second position.

Returns:

The distance from the first point to the second, in metres.

getCourse

public double getCourse(double lat1,
                        double lon1,
                        double lat2,
                        double lon2)

Returns the distance between two geographic points.

Parameters:

lat1 - The latitude of the first point.

lon1 - The longitude of the first point. Degrees west should be negative.

lat2 - The latitude of the second point.

lon2 - The longitude of the second point. Degrees west should be negative.

Returns:

The return bearing or course, in degrees.

getCourse

public double getCourse(AimsPoint pt1,
                        AimsPoint pt2)

Returns the distance between two geographic points.

Parameters:

pt1 - The first position.

pt2 - The second position.

Returns:

The return bearing or course, in degrees.

getDistanceAndCourse

public double[] getDistanceAndCourse(double lat1,
                                     double lon1,
                                     double lat2,
                                     double lon2)

Returns an array containin distance, course, and return course between two geographic points.

Parameters:

lat1 - The latitude of the first point.

lon1 - The longitude of the first point. Degrees west should be negative.

lat2 - The latitude of the second point.

lon2 - The longitude of the second point. Degrees west should be negative.

Returns:

An array containing:
element[0]: The distance from the first point to the second, in metres.
element[1]: The bearing or course from the first point to the second, in degrees.
element[2]: The return bearing or course, in degrees.

getDistanceAndCourse

public double[] getDistanceAndCourse(AimsPoint pt1,
                                     AimsPoint pt2)

Returns an array containin distance, course, and return course between two geographic points.

Parameters:

pt1 - The first position.

pt2 - The second position.

Returns:

An array containing:
element[0]: The distance from the first point to the second, in metres.
element[1]: The bearing or course from the first point to the second, in degrees.
element[2]: The return bearing or course, in degrees.