ucar.unidata.geoloc

Class Earth

java.lang.Object

ucar.unidata.geoloc.Earth

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

EarthEllipsoid

@Immutable
public class Earth
extends java.lang.Object
implements java.io.Serializable

Defines the shape of the earth ellipsoid. LOOK will not implement Serializable in ver6

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Earth	DEFAULT
static double	WGS84_EARTH_RADIUS_KM Get canonical radius of the spherical earth in km from "WGS 84"
static double	WGS84_EARTH_RADIUS_METERS Get canonical radius of the spherical earth in meters from "WGS 84"

Constructor Summary

Constructors

Constructor and Description
Earth() Spherical earth with canonical radius.
Earth(double radius) Create a spherical earth.
Earth(double equatorRadius, double poleRadius, double reciprocalFlattening) Create an ellipsoidal earth.
Earth(double equatorRadius, double poleRadius, double reciprocalFlattening, java.lang.String name) Create an ellipsoidal earth with a name.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
double	getEccentricity() Get the Eccentricity property.
double	getEccentricitySquared() Get the EccentricitySquared property.
double	getEquatorRadius() Get the EquatorRadius property.
double	getFlattening() Get the Flattening property.
double	getMajor() Get the equatorial radius (semimajor axis) of the earth, in meters.
double	getMinor() Get the polar radius (semiminor axis) of the earth, in meters.
java.lang.String	getName() Get the Name property.
double	getPoleRadius() Get the PoleRadius property.
int	hashCode()
boolean	isSpherical()
java.lang.String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT

public static final Earth DEFAULT

WGS84_EARTH_RADIUS_KM

public static final double WGS84_EARTH_RADIUS_KM

Get canonical radius of the spherical earth in km from "WGS 84"

See Also:

Constant Field Values

WGS84_EARTH_RADIUS_METERS

public static final double WGS84_EARTH_RADIUS_METERS

Get canonical radius of the spherical earth in meters from "WGS 84"

See Also:

Constant Field Values

Constructor Detail

Earth

public Earth()

Spherical earth with canonical radius.

Earth

public Earth(double radius)

Create a spherical earth.

Parameters:

radius - radius of spherical earth.

Earth

public Earth(double equatorRadius,
             double poleRadius,
             double reciprocalFlattening)

Create an ellipsoidal earth. The reciprocalFlattening is used if not zero, else the poleRadius is used.

Parameters:

equatorRadius - equatorial radius (semimajor axis) in meters, must be specified

poleRadius - polar radius (semiminor axis) in meters

reciprocalFlattening - inverse flattening = 1/flattening = a / (a-b)

Earth

public Earth(double equatorRadius,
             double poleRadius,
             double reciprocalFlattening,
             java.lang.String name)

Create an ellipsoidal earth with a name.

Parameters:

equatorRadius - equatorial radius (semimajor axis) in meters, must be specified

poleRadius - polar radius (semiminor axis) in meters; if reciprocalFlattening != 0 then this is ignored

reciprocalFlattening - inverse flattening = 1/flattening = a / (a-b); if 0 use the poleRadius to calculate

name - name of the Earth

Method Detail

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

getEccentricity

public double getEccentricity()

Get the Eccentricity property.

Returns:

The Eccentricity

getEccentricitySquared

public double getEccentricitySquared()

Get the EccentricitySquared property.

Returns:

The EccentricitySquared

getEquatorRadius

public double getEquatorRadius()

Get the EquatorRadius property.

Returns:

The EquatorRadius

getFlattening

public double getFlattening()

Get the Flattening property.

Returns:

The Flattening

getMajor

public double getMajor()

Get the equatorial radius (semimajor axis) of the earth, in meters.

Returns:

equatorial radius (semimajor axis) in meters

getMinor

public double getMinor()

Get the polar radius (semiminor axis) of the earth, in meters.

Returns:

polar radius (semiminor axis) in meters

getName

public java.lang.String getName()

Get the Name property.

Returns:

The Name

getPoleRadius

public double getPoleRadius()

Get the PoleRadius property.

Returns:

The PoleRadius

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

isSpherical

public boolean isSpherical()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object