geodetic_state_from_state_vector

Ellipsoid.geodetic_state_from_state_vector(self, r: ndarray[double], v: ndarray[double]) → ndarray[GeodeticState_dtype]

Convert Cartesian state vectors to geodetic states.

Given position and velocity vectors in an Earth-centered frame, this method computes the corresponding geodetic longitude, latitude, altitude and their time derivatives (rates).

Parameters:

rndarray of shape (3,) or (N, 3)

Position vector(s) in Cartesian coordinates [meters].

vndarray of shape (3,) or (N, 3)

Velocity vector(s) in Cartesian coordinates [meters/second].

Returns:

geostatendarray of GeodeticState_dtype, shape (N,) or (1,)

Structured array where each entry has the following fields:

• lonfloat

  Geodetic longitude [radians].

• latfloat

  Geodetic latitude [radians].

• altfloat

  Geodetic altitude [meters].

• lon_dotfloat

  Time derivative of longitude [radians/second].

• lat_dotfloat

  Time derivative of latitude [radians/second].

• alt_dotfloat

  Time derivative of altitude [meters/second].

Notes

• Input arrays may be a single state vector (shape (3,)) or a batch of state vectors (shape (N, 3)).

• The function internally calls a Cython implementation for performance.

• All angles are in radians.