Class ECEFCoordinate

java.lang.Object

org.episteme.natural.earth.coordinates.ECEFCoordinate

All Implemented Interfaces:

Serializable, GeometricObject<EarthCoordinate>, Positioned<EarthCoordinate>, EarthCoordinate

public final class ECEFCoordinate
extends Object
implements EarthCoordinate, Serializable

Earth-Centered, Earth-Fixed (ECEF) Cartesian coordinate system. This 3D coordinate system (X, Y, Z) has its origin at the center of the Earth. X-axis points towards the intersection of the Prime Meridian and the Equator. Y-axis points towards 90°E in the equatorial plane. Z-axis points towards the North Pole.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
ECEFCoordinate(Real x, Real y, Real z)
ECEFCoordinate(Real x, Real y, Real z, ReferenceEllipsoid ellipsoid)

Method Summary

Modifier and Type	Method	Description
int	ambientDimension()	Returns the dimension of the ambient space containing this object.
String	description()	Returns a human-readable description of this geometric object.
int	dimension()	Returns the intrinsic dimension of this geometric object.
Quantity<Length>	distanceTo(ECEFCoordinate other)	Calculates distance to another ECEF coordinate.
String	getCoordinateSystem()	Returns the coordinate system name (e.g., "WGS84", "UTM", "MGRS").
ReferenceEllipsoid	getEllipsoid()	Returns the reference ellipsoid used by this coordinate.
Quantity<Length>	getX()
Real	getXReal()
Quantity<Length>	getY()
Real	getYReal()
Quantity<Length>	getZ()
Real	getZReal()
ECEFCoordinate	toECEF()	Converts this coordinate to ECEF Cartesian form.
GeodeticCoordinate	toGeodetic()	Converts ECEF to Geodetic coordinates using Heikkinen's closed-form algorithm.
Point3D	toPoint3D()	Converts this ECEF coordinate to a standard 3D point.
String	toString()

Methods inherited from class Object

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

Methods inherited from interface EarthCoordinate

distanceTo, getPosition

Constructor Details

ECEFCoordinate

public ECEFCoordinate(Real x,
 Real y,
 Real z)

ECEFCoordinate

public ECEFCoordinate(Real x,
 Real y,
 Real z,
 ReferenceEllipsoid ellipsoid)

Method Details

getX

public Quantity<Length> getX()

getY

public Quantity<Length> getY()

getZ

public Quantity<Length> getZ()

getXReal

public Real getXReal()

getYReal

public Real getYReal()

getZReal

public Real getZReal()

getEllipsoid

public ReferenceEllipsoid getEllipsoid()

Description copied from interface: EarthCoordinate

Returns the reference ellipsoid used by this coordinate.

Specified by:

getEllipsoid in interface EarthCoordinate

Returns:

the ellipsoid model

getCoordinateSystem

public String getCoordinateSystem()

Description copied from interface: EarthCoordinate

Returns the coordinate system name (e.g., "WGS84", "UTM", "MGRS").

Specified by:

getCoordinateSystem in interface EarthCoordinate

Returns:

the coordinate system identifier

toECEF

public ECEFCoordinate toECEF()

Description copied from interface: EarthCoordinate

Converts this coordinate to ECEF Cartesian form.

Specified by:

toECEF in interface EarthCoordinate

Returns:

the ECEF representation

distanceTo

public Quantity<Length> distanceTo(ECEFCoordinate other)

Calculates distance to another ECEF coordinate.

toGeodetic

public GeodeticCoordinate toGeodetic()

Converts ECEF to Geodetic coordinates using Heikkinen's closed-form algorithm. Higher precision than iterative methods.

Specified by:

toGeodetic in interface EarthCoordinate

Returns:

the geodetic representation

toPoint3D

public Point3D toPoint3D()

Converts this ECEF coordinate to a standard 3D point.

Returns:

the Point3D representation

dimension

public int dimension()

Description copied from interface: GeometricObject

Returns the intrinsic dimension of this geometric object.

Examples:

• Point: 0
• Line/Segment: 1
• Plane/Surface: 2
• Volume: 3

Specified by:

dimension in interface EarthCoordinate

Specified by:

dimension in interface GeometricObject<EarthCoordinate>

Returns:

the dimension

ambientDimension

public int ambientDimension()

Description copied from interface: GeometricObject

Returns the dimension of the ambient space containing this object.

For example, a 2D plane in 3D space has dimension=2 but ambientDimension=3.

Specified by:

ambientDimension in interface EarthCoordinate

Specified by:

ambientDimension in interface GeometricObject<EarthCoordinate>

Returns:

the ambient space dimension

description

public String description()

Description copied from interface: GeometricObject

Returns a human-readable description of this geometric object.

Specified by:

description in interface EarthCoordinate

Specified by:

description in interface GeometricObject<EarthCoordinate>

Returns:

description string

toString

public String toString()

Overrides:

toString in class Object