Class Ellipsoid

  • All Implemented Interfaces:
    java.io.Serializable, java.lang.Cloneable

    public final class Ellipsoid
    extends java.lang.Object
    implements java.lang.Cloneable, java.io.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:
    Datum, Serialized Form
    • Field Detail

      • name

        public java.lang.String name
      • shortName

        public java.lang.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
      • KRASSOVSKY

        public static final Ellipsoid KRASSOVSKY
      • EVEREST

        public static final Ellipsoid EVEREST
      • INTERNATIONAL_1967

        public static final Ellipsoid INTERNATIONAL_1967
      • AUSTRALIAN

        public static final Ellipsoid AUSTRALIAN
      • APL4_9

        public static final Ellipsoid APL4_9
      • MOD_AIRY

        public static final Ellipsoid MOD_AIRY
      • ANDRAE

        public static final Ellipsoid ANDRAE
      • AUST_SA

        public static final Ellipsoid AUST_SA
      • BESS_NAM

        public static final Ellipsoid BESS_NAM
      • 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
      • PLESSIS

        public static final Ellipsoid PLESSIS
      • SEASIA

        public static final Ellipsoid SEASIA
      • WALBECK

        public static final Ellipsoid WALBECK
      • SPHERE

        public static final Ellipsoid SPHERE
      • ellipsoids

        public static final Ellipsoid[] ellipsoids
    • Constructor Detail

      • Ellipsoid

        public Ellipsoid()
      • Ellipsoid

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

        public Ellipsoid​(java.lang.String shortName,
                         double equatorRadius,
                         double eccentricity2,
                         java.lang.String name)
    • Method Detail

      • clone

        public java.lang.Object clone()
        Overrides:
        clone in class java.lang.Object
      • setName

        public void setName​(java.lang.String name)
      • getName

        public java.lang.String getName()
      • setShortName

        public void setShortName​(java.lang.String shortName)
      • getShortName

        public java.lang.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 java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • hashCode

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

        public boolean equals​(java.lang.Object that)
        Overrides:
        equals in class java.lang.Object