Geodetic and Geocentric Coordinates

Functions for converting between geodetic, geocentric, and ECEF coordinates.

Geodetic Conversions

position_geodetic_to_ecef builtin

position_geodetic_to_ecef(x_geod: ndarray, angle_format: AngleFormat) -> np.ndarray

Convert geodetic position to ECEF Cartesian coordinates.

Transforms a position from geodetic coordinates (latitude, longitude, altitude) using the WGS84 ellipsoid model to Earth-Centered Earth-Fixed (ECEF) Cartesian coordinates.

Parameters:

Name	Type	Description	Default
x_geod	ndarray	Geodetic position [latitude, longitude, altitude] where latitude is in radians or degrees, longitude is in radians or degrees, and altitude is in meters above the WGS84 ellipsoid.	required
angle_format	AngleFormat	Angle format for input angular coordinates (RADIANS or DEGREES).	required

Returns:

Type	Description
ndarray	ECEF Cartesian position [x, y, z] in meters.

position_ecef_to_geodetic builtin

position_ecef_to_geodetic(x_ecef: ndarray, angle_format: AngleFormat) -> np.ndarray

Convert ECEF Cartesian position to geodetic coordinates.

Transforms a position from Earth-Centered Earth-Fixed (ECEF) Cartesian coordinates to geodetic coordinates (latitude, longitude, altitude) using the WGS84 ellipsoid model.

Parameters:

Name	Type	Description	Default
x_ecef	ndarray	ECEF Cartesian position [x, y, z] in meters.	required
angle_format	AngleFormat	Angle format for output angular coordinates (RADIANS or DEGREES).	required

Returns:

Type	Description
ndarray	Geodetic position [latitude, longitude, altitude] where latitude is in radians or degrees, longitude is in radians or degrees, and altitude is in meters above the WGS84 ellipsoid.

Geocentric Conversions

position_geocentric_to_ecef builtin

position_geocentric_to_ecef(x_geoc: ndarray, angle_format: AngleFormat) -> np.ndarray

Convert geocentric position to ECEF Cartesian coordinates.

Transforms a position from geocentric spherical coordinates (latitude, longitude, radius) to Earth-Centered Earth-Fixed (ECEF) Cartesian coordinates.

Parameters:

Name	Type	Description	Default
x_geoc	ndarray	Geocentric position [latitude, longitude, radius] where latitude is in radians or degrees, longitude is in radians or degrees, and radius is in meters.	required
angle_format	AngleFormat	Angle format for input angular coordinates (RADIANS or DEGREES).	required

Returns:

Type	Description
ndarray	ECEF Cartesian position [x, y, z] in meters.

position_ecef_to_geocentric builtin

position_ecef_to_geocentric(x_ecef: ndarray, angle_format: AngleFormat) -> np.ndarray

Convert ECEF Cartesian position to geocentric coordinates.

Transforms a position from Earth-Centered Earth-Fixed (ECEF) Cartesian coordinates to geocentric spherical coordinates (latitude, longitude, radius).

Parameters:

Name	Type	Description	Default
x_ecef	ndarray	ECEF Cartesian position [x, y, z] in meters.	required
angle_format	AngleFormat	Angle format for output angular coordinates (RADIANS or DEGREES).	required

Returns:

Type	Description
ndarray	Geocentric position [latitude, longitude, radius] where latitude is in radians or degrees, longitude is in radians or degrees, and radius is in meters.