chaosmagpy.coordinate_utils.geo_to_gg

chaosmagpy.coordinate_utils.geo_to_gg(radius, theta)[source]

Compute geodetic colatitude and vertical height above the ellipsoid as defined by the World Geodetic System 1984 (WGS84) from geocentric radius and colatitude.

Parameters
radiusndarray, shape (…)

Geocentric radius in kilometers.

thetandarray, shape (…)

Geocentric colatitude in degrees.

Returns
heightndarray, shape (…)

Altitude in kilometers.

betandarray, shape (…)

Geodetic colatitude in degrees.

Notes

Round-off errors might lead to a failure of the algorithm especially but not exclusively for points close to the geographic poles. Corresponding geodetic coordinates are returned as NaN.

References

Function uses Heikkinen’s algorithm taken from:

Zhu, J., “Conversion of Earth-centered Earth-fixed coordinates to geodetic coordinates”, IEEE Transactions on Aerospace and Electronic Systems, 1994, vol. 30, num. 3, pp. 957-961