Class Ellipsoid

java.lang.Object
org.locationtech.proj4j.datum.Ellipsoid
All Implemented Interfaces:
Serializable, Cloneable

public final class Ellipsoid extends Object implements Cloneable, Serializable
A class representing a geographic reference ellipsoid (or more correctly an oblate spheroid), used to model the shape of the surface of the earth.

An oblate spheroid is a geometric surface formed by the rotation of an ellipse about its minor axis. In geodesy this is used as a convenient approximation to the geoid, the true shape of the earth's surface.

An ellipsoid is defined by the following parameters:

  • a, the equatorial radius or semi-major axis (see getA())
and one of:
  • b, the polar radius or semi-minor axis (see getB())
  • f, the reciprocal flattening (f = (a - b) / a)
In order to be used as a model of the geoid, the exact positioning of an ellipsoid relative to the geoid surface needs to be specified. This is provided by means of a geodetic Datum.

Notable ellipsoids in common use include CLARKE_1866, GRS80, and WGS84.

See Also:
  • Field Details

    • name

      public String name
    • shortName

      public String shortName
    • equatorRadius

      public double equatorRadius
    • poleRadius

      public double poleRadius
    • eccentricity

      public double eccentricity
    • eccentricity2

      public double eccentricity2
    • INTERNATIONAL

      public static final Ellipsoid INTERNATIONAL
    • BESSEL

      public static final Ellipsoid BESSEL
    • CLARKE_1866

      public static final Ellipsoid CLARKE_1866
    • CLARKE_1880

      public static final Ellipsoid CLARKE_1880
    • AIRY

      public static final Ellipsoid AIRY
    • WGS60

      public static final Ellipsoid WGS60
    • WGS66

      public static final Ellipsoid WGS66
    • WGS72

      public static final Ellipsoid WGS72
    • WGS84

      public static final Ellipsoid WGS84
    • KRASSOVSKY

      public static final Ellipsoid KRASSOVSKY
    • EVEREST

      public static final Ellipsoid EVEREST
    • INTERNATIONAL_1967

      public static final Ellipsoid INTERNATIONAL_1967
    • GRS80

      public static final Ellipsoid GRS80
    • AUSTRALIAN

      public static final Ellipsoid AUSTRALIAN
    • MERIT

      public static final Ellipsoid MERIT
    • SGS85

      public static final Ellipsoid SGS85
    • IAU76

      public static final Ellipsoid IAU76
    • APL4_9

      public static final Ellipsoid APL4_9
    • NWL9D

      public static final Ellipsoid NWL9D
    • MOD_AIRY

      public static final Ellipsoid MOD_AIRY
    • ANDRAE

      public static final Ellipsoid ANDRAE
    • AUST_SA

      public static final Ellipsoid AUST_SA
    • GRS67

      public static final Ellipsoid GRS67
    • BESS_NAM

      public static final Ellipsoid BESS_NAM
    • CPM

      public static final Ellipsoid CPM
    • DELMBR

      public static final Ellipsoid DELMBR
    • ENGELIS

      public static final Ellipsoid ENGELIS
    • EVRST48

      public static final Ellipsoid EVRST48
    • EVRST56

      public static final Ellipsoid EVRST56
    • EVRTS69

      public static final Ellipsoid EVRTS69
    • EVRTSTSS

      public static final Ellipsoid EVRTSTSS
    • FRSCH60

      public static final Ellipsoid FRSCH60
    • FSRCH60M

      public static final Ellipsoid FSRCH60M
    • FSCHR68

      public static final Ellipsoid FSCHR68
    • HELMERT

      public static final Ellipsoid HELMERT
    • HOUGH

      public static final Ellipsoid HOUGH
    • INTL

      public static final Ellipsoid INTL
    • KAULA

      public static final Ellipsoid KAULA
    • LERCH

      public static final Ellipsoid LERCH
    • MPRTS

      public static final Ellipsoid MPRTS
    • PLESSIS

      public static final Ellipsoid PLESSIS
    • SEASIA

      public static final Ellipsoid SEASIA
    • WALBECK

      public static final Ellipsoid WALBECK
    • NAD27

      public static final Ellipsoid NAD27
    • NAD83

      public static final Ellipsoid NAD83
    • SPHERE

      public static final Ellipsoid SPHERE
    • ellipsoids

      public static final Ellipsoid[] ellipsoids
  • Constructor Details

    • Ellipsoid

      public Ellipsoid()
    • Ellipsoid

      public Ellipsoid(String shortName, double equatorRadius, double poleRadius, double reciprocalFlattening, String name)
      Creates a new Ellipsoid. One of of poleRadius or reciprocalFlattening must be specified, the other must be zero
    • Ellipsoid

      public Ellipsoid(String shortName, double equatorRadius, double eccentricity2, String name)
  • Method Details

    • clone

      public Object clone()
      Overrides:
      clone in class Object
    • setName

      public void setName(String name)
    • getName

      public String getName()
    • setShortName

      public void setShortName(String shortName)
    • getShortName

      public String getShortName()
    • setEquatorRadius

      public void setEquatorRadius(double equatorRadius)
    • getEquatorRadius

      public double getEquatorRadius()
    • getA

      public double getA()
    • getB

      public double getB()
    • setEccentricitySquared

      public void setEccentricitySquared(double eccentricity2)
    • getEccentricitySquared

      public double getEccentricitySquared()
    • isEqual

      public boolean isEqual(Ellipsoid e)
    • isEqual

      public boolean isEqual(Ellipsoid e, double e2Tolerance)
    • toString

      public String toString()
      Overrides:
      toString in class Object
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • equals

      public boolean equals(Object that)
      Overrides:
      equals in class Object