CL_stela_convert

Description

• Convert orbital elements from mean to osculating or vice versa.

  The input orbital elements are internally converted to the adequate type and frame before the call to STELA. The results are then converted back to the initial type and frame.

• Notes:

  - The integration time step parameter (in the "params" structure) is not used but must exist.

• See the STELA page for more details.

Parameters

cmd:

(string) Wanted operation: "mean2osc" or "osc2mean"

type_oe:

(string) Type of orbital elements: "kep", "cir", "cireq", "equin", "pv".

cjd:

epochs (CJD, time scale: TREF) (1xN)

oe:

Mean or osculating orbital elements (6xN)

params:

(structure) Propagation model parameters.

frame:

(string, optional) Input/output frame. Default is "ECI"

ut1_tref:

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

tt_tref:

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

oe2:

Osculating or Mean orbital elements (6xN)

Authors

• CNES - DCT/SB/MS

Examples

// Date (cjd, TREF) and Keplerian mean orbital elements cjd = 20000; mean_kep = [7.e6; 1.e-3; 1.7; 1; 2; 3]; // STELA model parameters (default values) params = CL_stela_params(); // Convert to osculating elements osc_kep = CL_stela_convert("mean2osc", "kep", cjd, mean_kep, params); // Check: convert back to mean elements mean_kep2 = CL_stela_convert("osc2mean", "kep", cjd, osc_kep, params); mean_kep2 - mean_kep // => 0