Help: Upload trajectory

The option to upload a trajectory is available only for Advanced users.

Overview

The SPENVIS upload trajectory option can be used to upload trajectory file corresponding to an orbit around Earth, Mars or Jupiter.

With the trajectory upload option, only one mission segment can be specified. Only one additional parameter needs to be specified, i.e. the mission length.

A user has the possibility to choose between uploading a new trajectory file and using a file that has been already uploaded.

Trajectory file

The uploaded trajectory file should consist of a header section and a body section.

Note that comments can be also included in the uploaded file. Any line that begins with " # ", " ! ", " * " or " // " will be assumed to be a comment.

Header section

The records included in the header contain general information on the data (title, reference planet etc) and a description of the content of the body section. More specificly, the header section should contain five records starting with the following character strings:

Title
Planet
Coordinates
Columns
Format

followed by a valid header separator and the users input. Note that only the characters " , " , " ; ", " : " and " = " can be used as header separators.

The Title input can be any character string.

The Planet record specifies the planet that the orbit refers to and the input can be Earth, Mars or Jupiter.

The Coordinates record includes information about the coordinate system used for calculating the trajectory data included in the body section. The users input can be Planetocentric_equatorial_inertial, PEI, GEI, Planetographic, Geographic, or GEO.

Planet	Coord. System	x-axis	z-axis	x-y plane	Remarks
Earth	GEI	Pointing to vernal equinox (point of Aries) at epoch B1950	Earth's rotation axis (B1950)	Earth's mean equator at epoch B1950	Inertial, right-handed
	Geographic/GEO	Out along the intersection of Earth's equator and its prime meridian (Greenwich)	Earth's rotation axis	Earth's equator	Non-inertial, right-handed
Mars (*)	PEI	Out along the intersection of the ICRF equator and Mars J2000 mean equator (ascending node)	Mars rotation axis (J2000)	Mean equator of Mars at epoch J2000	Inertial, right-handed
	Planetographic	Out along the intersection of mean equator of Mars and its prime meridian (Airy-0)	Mars rotation axis	Mars equator	Non-inertial, right-handed
Jupiter (*)	PEI	Out along the intersection of the ICRF equator and Jupiter's J2000 mean equator (ascending node)	Jupiter's rotation axis (J2000)	Mean equator of Jupiter at epoch J2000	Inertial, right-handed
	Planetographic	Out along the intersection of mean equator of Jupiter and its prime meridian (System III)	Jupiter's rotation axis	Jupiter's equator	Non-inertial, right handed

(*) As defined in Seidelmann, P. K., et al.: 2002, Report of the IAU/IAGWorking Group on cartographic coordinates and rotational elements: 2000, Celestial Mech. Dyn. Astr. 82, 83111

The Columns record defines the number and names of the variables of the data set. The input can be JDCT (Julian date) or AMJD (Modified Julian date) or DYEA, DMON, DDAY, DHOU, DMIN, DSEC (date) and X, Y, Z (position vector in the appropriate coordinate system).

Finally, the Format record refers to the format of the data set and can be either CSV (data separated by " , " or " ; ") or Free (data separated by space).

Warning: The users input for the Planet, Coordinates, Columns and Format records are case sensitive.

Body section

The trajectory data must be included between the lines $$BEGIN and $$END. Each record of the body section contains the values associated to the variables specified at the Columns header record.

The input for the X, Y and Z (position vector) must be provided in km.

Examples

Part of sample trajectory files are given below:

Example 1a: Rosetta's first Earth flyby (CSV format)

******************************************************************
* Geocentric trajectory of Rosetta's first Earth flyby.
*
* Taken from:
*  http://www.lepp.cornell.edu/~seb/celestia/spacecraft.html#3.4.5
******************************************************************
Title: Rosetta first Earth flyby
Planet: Earth
Coordinates: GEI
Columns: JDCT, X, Y, Z
Format: CSV
******************************************************************
$$BEGIN
2453427.500,   -2358221.228,   552722.0993,   98289.65571
2453427.507,   -2355913.806,   552192.5571,   98201.38984
2453427.514,   -2353606.41,    551663.0371,   98113.13659
2453427.521,   -2351299.04,    551133.5394,   98024.89595
2453427.528,   -2348991.695,   550604.0639,   97936.6679
2453427.535,   -2346684.375,   550074.6106,   97848.45244
$$END

Example 1b: Rosetta's first Earth flyby (Free format)

******************************************************************
Title: Rosetta plausible trajectory
Planet: Earth
Coordinates: GEO
Columns: DYEA, DMON, DDAY, DHOU, DMIN, DSEC, X, Y, Z
Format: Free
******************************************************************
$$BEGIN
2005 03 04 10 10 0.000000 -1.871524e+05 -9.881072e+04  1.945766e+04
2005 03 04 10 11 0.000000 -1.873636e+05 -9.785346e+04  1.944809e+04
2005 03 04 10 12 0.000000 -1.875696e+05 -9.689598e+04  1.943846e+04
2005 03 04 10 13 0.000000 -1.877708e+05 -9.593857e+04  1.942884e+04
$$END

Example 2: Mars Express (18 Jan 2005)

*******************************************************************************
* Mars Express orbit around Mars.
*
* Generated using JPL's HORIZONS system:
*                  http://ssd.jpl.nasa.gov/horizons.cgi#top
*
* Revised: Oct 28, 2009              Mars Express / (Sun)                    -41 
*                            http://sci.esa.int/marsexpress/
*                  http://space.about.com/od/spacemissions/p/beagle2.htm
* 
* LAUNCH DATE:                                             MARS ARRIVAL DATE:
*  June 02, 2003                                            December, 2003 
*
******************************************************************************
*Ephemeris / WWW_USER Tue Nov 10 08:07:21 2009  Pasadena, USA     / Horizons    
*******************************************************************************
*Target body name: Mars Express Spacecraft (-41)   {source: /home/adcs/v2.0r4/tmp/20}
*Center body name: Mars (499)                      {source: MAR080}
*Center-site name: BODY CENTER
*******************************************************************************
*Start time      : A.D. 2005-Jan-18 00:00:00.0000 CT 
*Stop  time      : A.D. 2005-Jan-19 00:00:00.0000 CT 
*Step-size       : 1 minutes
*******************************************************************************
*Center geodetic : 0.00000000,0.00000000,0.0000000 {E-lon(deg),Lat(deg),Alt(km)}
*Center cylindric: 0.00000000,0.00000000,0.0000000 {E-lon(deg),Dxy(km),Dz(km)}
*Center pole/equ : IAU_MARS                        {East-longitude -}
*Center radii    : 3396.2 x 3396.2 x 3376.2 km     {Equator, meridian, pole}    
*Output units    : KM-S                                                         
*Output format   : 01
*Output type     : GEOMETRIC cartesian states
*Coordinate systm: Body Mean Equator and Node of Date                           
*******************************************************************************
Title: Mars Express 18 Jan 2005 
Planet: Mars
Coordinates: Planetocentric_equatorial_inertial
Columns: JDCT, X, Y, Z
Format: CSV
$$BEGIN
2453388.500000000, -1.029747487336194E+04, -3.615769699884976E+03, -7.340070300570826E+03,
2453388.500694444, -1.031882481054190E+04, -3.628668749934330E+03, -7.270067508184303E+03,
2453388.501388889, -1.033947256957535E+04, -3.641320876304438E+03, -7.199569800648907E+03,
2453388.502083333, -1.035941366186371E+04, -3.653724132171881E+03, -7.128579829081391E+03,
2453388.502777778, -1.037864353532344E+04, -3.665876545083223E+03, -7.057100252049757E+03,
2453388.503472222, -1.039715757308989E+04, -3.677776116373720E+03, -6.985133736648369E+03,
2453388.504166667, -1.041495109192248E+04, -3.689420820494233E+03, -6.912682958736985E+03,
2453388.504861111, -1.043201934085958E+04, -3.700808604221676E+03, -6.839750608686652E+03,
2453388.505555556, -1.044835750289488E+04, -3.711937387720053E+03, -6.766339382653385E+03,
2453388.506250000, -1.046396068906545E+04, -3.722805061665317E+03, -6.692451992494963E+03,
$$END

Example 3: Pioneer10 Jupiter flyby

******************************************************************
* Jovicentric trajectory of Pioneer10 Jupiter flyby.
*
* Generated using JPL's HORIZONS system:
*                  http://ssd.jpl.nasa.gov/horizons.cgi#top
*
* The spacecraft achieved its closest approach to Jupiter on December 4, 1973 
* (UTC), when it reached approximately 2.8 Jovian radii (about 200,000 km). 
*
*******************************************************************************
*Ephemeris / WWW_USER Tue Nov  3 08:05:15 2009  Pasadena, USA     / Horizons    
*******************************************************************************
*Target body name: Pioneer 10 Spacecraft (-23)     {source: pfile10.nio}
*Center body name: Jupiter (599)                   {source: JUP266}
*Center-site name: BODY CENTER
*******************************************************************************
*Start time      : A.D. 1973-Dec-03 19:24  CT 
*Stop  time      :  9:26  CT 
*Step-size       : 1 minutes
*******************************************************************************
*Center geodetic : 0.00000000,0.00000000,0.0000000 {E-lon(deg),Lat(deg),Alt(km)}
*Center cylindric: 0.00000000,0.00000000,0.0000000 {E-lon(deg),Dxy(km),Dz(km)}
*Center pole/equ : IAU_JUPITER                     {East-longitude -}
*Center radii    : 71492.0 x 71492.0 x 66854.0 km  {Equator, meridian, pole}    
*Output units    : KM-S                                                         
*Output format   : 01
*Output type     : GEOMETRIC cartesian states
*Coordinate systm: Body Mean Equator and Node of Date                           
*******************************************************************************
Title: Pioneer10 Jupiter flyby 
Planet: Jupiter
Coordinates: PEI
Columns: JDCT, X, Y, Z
Format: CSV
*******************************************************************************
$$BEGIN
2442020.308333333, -5.019864614163744E+05,  3.258044723121225E+05, -1.351416776295713E+05
2442020.309027778, -5.014590008977164E+05,  3.246045898309209E+05, -1.349621697129346E+05
2442020.309722222, -5.009305435925442E+05,  3.234040619516929E+05, -1.347823932832207E+05
2442020.310416667, -5.004010851236670E+05,  3.222028875569500E+05, -1.346023472357111E+05
2442020.311111111, -4.998706210860926E+05,  3.210010655299479E+05, -1.344220304590073E+05
2442020.311805556, -4.993391470468004E+05,  3.197985947547547E+05, -1.342414418349809E+05
2442020.312500000, -4.988066585445156E+05,  3.185954741163167E+05, -1.340605802387207E+05
2442020.313194444, -4.982731510894773E+05,  3.173917025005285E+05, -1.338794445384817E+05
2442020.313888889, -4.977386201632117E+05,  3.161872787942989E+05, -1.336980335956304E+05
2442020.314583333, -4.972030612182950E+05,  3.149822018856226E+05, -1.335163462645924E+05
$$END

Table of Contents	ECSS	Model Page
Background information	Orbit generator
	Trajectory upload