Ellipsoid

class spacekernel.mathtools.ellipsoid.Ellipsoid(double Re, double f)

Bases: object

Represents an ellipsoid with specific geometric properties and provides methods for various geographical calculations.

The Ellipsoid class models an ellipsoidal shape using its equatorial radius and flattening factor. It provides efficient methods to perform geographical calculations, including surface normal vector computation, surface tangent vector computation, and conversions between reduced and geodetic latitudes.

Parameters:

Redouble

The equatorial radius of the ellipsoid (in meters). Must be greater than zero.

fdouble

The flattening factor of the ellipsoid. Must be in the range [0.0, 1.0).

Attributes

Re	Ellipsoid equatorial radius (in meters).
f	The flattening factor of the ellipsoid. Between [0.0, 1.0).

Methods

Ellipsoid.enu(self, lat, lon)	Compute the local East–North–Up (ENU) unit‐vector frame on the ellipsoid surface.
Ellipsoid.reduced_lat_from_geodetic_lat(...)	Vectorized conversion from geodetic latitude \(\phi\) to reduced latitude \(\beta\).
Ellipsoid.geodetic_lat_from_reduced_lat(...)	Vectorized conversion from reduced latitude \(\beta\) to geodetic latitude \(\phi\).
Ellipsoid.surf_pos_from_surf_coord(self, ...)	Compute the ECEF surface position vector(s) on the reference ellipsoid.
Ellipsoid.surf_coord_from_surf_pos(self, r_surf)	Compute geodetic latitude and longitude from ECEF surface position vector(s).
Ellipsoid.solve_reduced_lat_equation(self, r)	Compute the reduced (parametric) latitude \(\beta\) from ECEF position vector(s).
Ellipsoid.lla_from_pos(self, r)	Convert ECEF position vector(s) to geodetic latitude, longitude, and altitude.
Ellipsoid.pos_from_lla(self, lat, lon, alt)	Compute ECEF position vector(s) from geodetic coordinates.
Ellipsoid.geodetic_state_from_state_vector(...)	Convert Cartesian state vectors to geodetic states.
Ellipsoid.state_vector_from_geodetic_state(...)	Convert geodetic state(s) to Cartesian state vector(s).
Ellipsoid.surf_pos_of_ray_first_intersection(...)	Compute the first ellipsoid‐surface intersection of a ray.
Ellipsoid.aer_coords(self, r_target, ...)	Compute azimuth, elevation, and range (AER) from an observer to target point(s).

C-level Methods

c_reduced_lat_from_geodetic_lat	Compute the reduced (parametric) latitude β from a geodetic latitude φ.
c_geodetic_lat_from_reduced_lat	Inverse: geodetic latitude φ from reduced latitude β.