CL_tle_getElem

Description

• Returns the mean orbital elements in a TLE structure.

  The orbital elements can be returned in various forms: Keplerian elements, position and velocity...

  In a standard situation, the orbital elements are converted to the specified reference frame. The epoch (internally in UTC) is converted to the TREF time scale. Note that if the frame is not a true equator frame, the transformation may not as accurate as should be as the frame transformation arguments that can be provided are limited to ut1_tref and tt_tref.

  It is also possible to give frame a special value: "native". It means that the output reference frame AND time scale are those natively used for TLEs: TEME and UTC repectively. No conversion is performed.

Parameters

tle:

TLE structure (size N)

type_oe:

(string) Type of output orbital elements: "kep", "cir", "cireq", "equin" or "pv" (1x1)

frame:

(string, optional) Output frame, see above for details. Default is "ECI".

ut1_tref:

(optional) UT1-TREF [seconds]. Default is %CL_UT1_TREF (1xN or 1x1)

tt_tref:

(optional) TT-TREF [seconds]. Default is %CL_TT_TREF (1xN or 1x1)

mean_oe:

Mean orbital elements (of type given by "type_oe") relative to the specified frame [m, m/s, rad] (6xN)

cjd:

TLE epoch (modified julian date from 1950.0, TREF time scale except if frame == "native") (1xN)

Authors

• CNES - DCT/SB/MS

See also

• CL_tle_setElem

Examples

str = [.. "1 00005U 58002B 00179.78495062 .00000023 00000-0 28098-4 0 4753"; .. "2 00005 34.2682 348.7242 1859667 331.7664 19.3264 10.82419157413667" ]; tle = CL_tle_parse(str); // cjd in TREF, mean_kep relative to ECI [mean_kep, cjd] = CL_tle_getElem(tle, "kep")