CL_fr_bodyConvert

Description

• Converts position and (optionally) velocity vectors relative to "frame1" to position and (optionally) velocity vectors relative to "frame2".

  The jacobian of the transformation is optionally computed.

• Available frames are :

  'ICRS': International Celestial Reference System

  'BCI': Body Centered Inertial

  'BCF': Body Centered body Fixed

  See Reference frames for more details on the definition of reference frames.

  Available bodies are: "Mercury","Venus","Mars","Jupiter","Saturn","Uranus", "Neptune", "Sun" and "Moon"

• Notes :

  - The date "cjd" is relative to the TREF time scale.

  - The frame names and body names are case sensitive

  - If only the position needs to be converted, vel1 can be omitted or set to []. (vel2 will then be set to []).

  - Earth is not a valid body for this function. See CL_fr_convert.

  - GCRS (identical to ICRS in CelestLab) is also accepted as a frame name.

Parameters

body:

(string) Name of the body. ("Mercury","Venus","Mars","Jupiter","Saturn","Uranus", "Neptune", "Sun" or "Moon") (1x1)

frame1:

(string) Name of the initial frame. (1x1)

frame2:

(string) Name of the final frame. (1x1)

cjd:

Modified (1950.0) julian day (Time scale: TREF) (1xN or 1x1)

pos1:

Position vector in initial frame. (3xN or 3x1)

vel1:

Velocity vector in initial frame. (3xN or 3x1)

tt_tref:

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

pos2:

Position vector in final frame. (3xN or 3x1)

vel2:

(optional) Velocity vector in final frame. (3xN or 3x1)

jacob:

(optional) Jacobian of the transformation (6x6xN)

Authors

• CNES - DCT/SB

Bibliography

• Report of the IAU/IAG working group on cartographic coordinates and rotational elements: 2009

See also

• CL_mod_IAUBodyAngles

• CL_fr_bodyConvertMat

• CL_fr_convert

Examples

cjd = CL_dat_cal2cjd(2010,02,03,05,35,25); // ICRS to BCF pos_EME2000 = [1e5;3e4;6e6]; vel_EME2000 = [-1e3;3e3;6e3]; [pos_BCF,vel_BCF] = CL_fr_bodyConvert("Mars","ICRS","BCI",cjd,pos_EME2000,vel_EME2000);