Package org.locationtech.proj4j.datum

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