Class CoordinateConverter

java.lang.Object

org.episteme.natural.earth.coordinates.CoordinateConverter

public final class CoordinateConverter
extends Object

High-level utility for seamless coordinate conversions. Supports Geodetic, ECEF, UTM, MGRS, and Topocentric systems.

Since:

1.0

Author:

Silvere Martin-Michiellot, Gemini AI (Google DeepMind)

Field Summary

Fields

Modifier and Type	Field	Description
static final LambertAzimuthalEqualAreaCoordinate.LAEAParameters	EUROPE_LAEA	Parameters for the Lambert Azimuthal Equal-Area projection centered on Europe.
static final BonneCoordinate.BonneParameters	FRANCE_STATE_MAJOR_BONNE	Parameters for the Bonne projection as used for the French "Carte de l'État-Major".
static final CassiniSoldnerCoordinate.CassiniParameters	UK_ORDNANCE_SURVEY_CASSINI	Parameters for the Cassini-Soldner projection used by the UK Ordnance Survey (e.g., for the Great Britain National Grid).

Method Summary

Modifier and Type	Method	Description
static GeodeticCoordinate	fromECEF(ECEFCoordinate ecef)	Converts ECEF to Geodetic.
static GeodeticCoordinate	fromUTM(UTMCoordinate utm)	Converts UTM back to Geodetic.
static AlbersEqualAreaCoordinate	toAlbers(GeodeticCoordinate geodetic, AlbersEqualAreaCoordinate.AlbersParameters params)	Converts a geodetic point to Albers Equal-Area Conic.
static BonneCoordinate	toBonne(GeodeticCoordinate geodetic, BonneCoordinate.BonneParameters params)	Converts a geodetic point to Bonne.
static CassiniSoldnerCoordinate	toCassini(GeodeticCoordinate geodetic, CassiniSoldnerCoordinate.CassiniParameters params)	Converts a geodetic point to Cassini-Soldner.
static ECEFCoordinate	toECEF(GeodeticCoordinate geodetic)	Converts a geodetic point to ECEF XYZ.
static LambertAzimuthalEqualAreaCoordinate	toLAEA(GeodeticCoordinate geodetic, LambertAzimuthalEqualAreaCoordinate.LAEAParameters params)	Converts a geodetic point to Lambert Azimuthal Equal-Area.
static LambertConformalConicCoordinate	toLambert(GeodeticCoordinate geodetic, LambertConformalConicCoordinate.LCCParams params)	Converts a geodetic point to Lambert Conformal Conic.
static AERCoordinate	toLocalAER(GeodeticCoordinate target, GeodeticCoordinate observer)	Converts a target geodetic point to local AER (Azimuth, Elevation, Range) relative to an observer.
static ENUCoordinate	toLocalENU(GeodeticCoordinate target, GeodeticCoordinate observer)	Converts a target geodetic point to local ENU relative to an observer.
static MercatorCoordinate	toMercator(GeodeticCoordinate geodetic, boolean webMercator)	Converts a geodetic point to Mercator.
static MGRSCoordinate	toMGRS(GeodeticCoordinate geodetic)	Converts a geodetic point to MGRS.
static PolyconicCoordinate	toPolyconic(GeodeticCoordinate geodetic, PolyconicCoordinate.PolyconicParameters params)	Converts a geodetic point to Polyconic.
static UPSCoordinate	toUPS(GeodeticCoordinate geodetic)	Converts a geodetic point to UPS (Universal Polar Stereographic).
static UTMCoordinate	toUTM(GeodeticCoordinate geodetic)	Converts a geodetic point to UTM.

Methods inherited from class Object

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

Field Details

EUROPE_LAEA

public static final LambertAzimuthalEqualAreaCoordinate.LAEAParameters EUROPE_LAEA

Parameters for the Lambert Azimuthal Equal-Area projection centered on Europe.

FRANCE_STATE_MAJOR_BONNE

public static final BonneCoordinate.BonneParameters FRANCE_STATE_MAJOR_BONNE

Parameters for the Bonne projection as used for the French "Carte de l'État-Major".

UK_ORDNANCE_SURVEY_CASSINI

public static final CassiniSoldnerCoordinate.CassiniParameters UK_ORDNANCE_SURVEY_CASSINI

Parameters for the Cassini-Soldner projection used by the UK Ordnance Survey (e.g., for the Great Britain National Grid).

Method Details

toAlbers

public static AlbersEqualAreaCoordinate toAlbers(GeodeticCoordinate geodetic,
 AlbersEqualAreaCoordinate.AlbersParameters params)

Converts a geodetic point to Albers Equal-Area Conic.

toCassini

public static CassiniSoldnerCoordinate toCassini(GeodeticCoordinate geodetic,
 CassiniSoldnerCoordinate.CassiniParameters params)

Converts a geodetic point to Cassini-Soldner.

toPolyconic

public static PolyconicCoordinate toPolyconic(GeodeticCoordinate geodetic,
 PolyconicCoordinate.PolyconicParameters params)

Converts a geodetic point to Polyconic.

toLAEA

public static LambertAzimuthalEqualAreaCoordinate toLAEA(GeodeticCoordinate geodetic,
 LambertAzimuthalEqualAreaCoordinate.LAEAParameters params)

Converts a geodetic point to Lambert Azimuthal Equal-Area.

toBonne

public static BonneCoordinate toBonne(GeodeticCoordinate geodetic,
 BonneCoordinate.BonneParameters params)

Converts a geodetic point to Bonne.

toLambert

public static LambertConformalConicCoordinate toLambert(GeodeticCoordinate geodetic,
 LambertConformalConicCoordinate.LCCParams params)

Converts a geodetic point to Lambert Conformal Conic.

toMercator

public static MercatorCoordinate toMercator(GeodeticCoordinate geodetic,
 boolean webMercator)

Converts a geodetic point to Mercator.

toUPS

public static UPSCoordinate toUPS(GeodeticCoordinate geodetic)

Converts a geodetic point to UPS (Universal Polar Stereographic).

toUTM

public static UTMCoordinate toUTM(GeodeticCoordinate geodetic)

Converts a geodetic point to UTM.

toMGRS

public static MGRSCoordinate toMGRS(GeodeticCoordinate geodetic)

Converts a geodetic point to MGRS.

toECEF

public static ECEFCoordinate toECEF(GeodeticCoordinate geodetic)

Converts a geodetic point to ECEF XYZ.

toLocalENU

public static ENUCoordinate toLocalENU(GeodeticCoordinate target,
 GeodeticCoordinate observer)

Converts a target geodetic point to local ENU relative to an observer.

toLocalAER

public static AERCoordinate toLocalAER(GeodeticCoordinate target,
 GeodeticCoordinate observer)

Converts a target geodetic point to local AER (Azimuth, Elevation, Range) relative to an observer.

fromECEF

public static GeodeticCoordinate fromECEF(ECEFCoordinate ecef)

Converts ECEF to Geodetic.

fromUTM

public static GeodeticCoordinate fromUTM(UTMCoordinate utm)

Converts UTM back to Geodetic.