User Manual 3.3 Orbital parameters

User Manual 3.3 Orbital parameters

Introduction

Scope

The "Orbital parameters" package contains classes to represent the orbital state of a space object. Several types of parameters are available (cartesian, keplerian, equinoctial... with different position angle definitions : true, mean, eccentric). Orbital parameters do not define a date nor a frame. To fully define an orbit, including date and frame, please refer to [FDY_Orbits_Home Orbits].

Javadoc

The classes for orbital parameters description are available in the package org.orekit.orbits.orbitalparameters of OREKIT.

|=Library|=Javadoc | Orekit|Package org.orekit.orbits.orbitalparameters

Package Overview

All different orbital parameters types extend the abstract class AbstractOrbitalParameters and implement the interface IOrbitalParameters.

All conversions methods from one type to another are specifically handled by each type of orbital parameters, thus optimising conversions.

Features Description

Available parameters

The available parameters types are :

• Cartesian  : X, Y, Z, Vx, Vy, Vz
• Keplerian : a, e, i, perigee argument, right ascension of ascending node, anomaly (in each position angle types)
• Equinoctial : a, ex, ey (eccentricity vector), hx, hy (inclination vector), longitude argument (in each position angle types)
• Stela Equinoctial : a, ex, ey (eccentricity vector), ix, iy (inclination vector), mean longitude argument
• Circular : a, ex, ey (eccentricity vector), i, right ascension of ascending node, latitude argument (in each position angle types)
• Apsis (using radius) : periapsis, apoapsis, i, perigee argument, right ascension of ascending node, anomaly (in each position angle types)
• Apsis (using altitude) : altitude of periapsis, altitude of apoapsis, i, perigee argument, right ascension of ascending node, anomaly (in each position angle types)
• Equatorial : a, e, longitude of the periapsis (ω + Ω), ix (first component of inclination vector), iy (second component of inclination vector), anomaly (in each position angle types)
• Reentry : altitude, latitude, longitude, velocity norm, slope of velocity, azimuth of velocity

Getting Started

Any orbital parameters can be defined using the chosen constructor. Here is an example using circular parameters and true anomaly:

final CircularParameters circularParameters = new CircularParameters(10000E3, 0.1, 0.2, 0.3, 0.4, 0.5, PositionAngle.TRUE, Constants.EGM96_EARTH_MU);

Then conversions to any orbital parameters type can directly be obtained using the conversion routines. Here is an example of conversion to equinoctial parameters:

final EquinoctialParameters equinoctialParameters = circularParameters .getEquinoctialParameters();

Contents

Classes

|=(% colspan="3" %)Class|=(% colspan="6" %)Summary|=(% colspan="1" %)Javadoc |(% colspan="3" %)CartesianParameters|(% colspan="6" %)Cartesian parameters object.|(% colspan="1" %)... |(% colspan="3" %)KeplerianParameters|(% colspan="6" %)Keplerian parameters object.|(% colspan="1" %)... |(% colspan="3" %)CircularParameters|(% colspan="6" %)Circular parameters object.|(% colspan="1" %)... |(% colspan="3" %)EquinoctialParameters|(% colspan="6" %)Equinoctial parameters object.|(% colspan="1" %)... |(% colspan="3" %)StelaEquinoctialParameters|(% colspan="6" %)Stela equinoctial parameters object.|(% colspan="1" %)... |(% colspan="3" %)EquatorialParameters|(% colspan="6" %)Equatorial parameters object.|(% colspan="1" %)... |(% colspan="3" %)ApsisRadiusParameters|(% colspan="6" %)Apsis parameters object (using radius).|(% colspan="1" %)... |(% colspan="3" %)ApsisAltitudeParameters|(% colspan="6" %)Apsis parameters object (using altitude).|(% colspan="1" %)... |(% colspan="3" %)ReentryParameters|(% colspan="6" %)Reentry parameters object.|(% colspan="1" %)...

Tips & Tricks

None as of now.