-
Notifications
You must be signed in to change notification settings - Fork 80
Orbit analysis
The orbit analysis tool provides information about the current trajectory, seen as a perturbed Kepler orbit.
The orbit analysis tool analyses the current trajectory of the active vessel, as an orbit around an automatically detected primary. The trajectory is analysed over a given mission duration.
The computation occurs in the background; it is tracked by a progress bar.
Below the progress bar is the orbit analysis report from the last computation.
The tool indicates the lowest altitude that will be reached over the mission duration, and indicates whether the spacecraft will reenter, risk collision (that is, reach an altitude lower than that of the highest terrain), or certainly collide within the mission duration.
Example on an orbit that comes dangerously low:
![]()
Three periods are given.
- The sidereal period is the period of the mean longitude
$Ω+ω+M$ . - The nodal period is the period of the (mean*) mean argument of latitude
$ω+M$ . This approximately corresponds to the time between successive ascending nodes. - The anomalistic period is the period of the (mean*) mean anomaly
$M$ . This approximately corresponds to the time between successive periapsides.
In a Kepler orbit, the longitude of the ascending node
* These elements are a moving average over one sidereal period of the orbital elements called the mean argument of latitude
Example on a Молния orbit with RSS:
![]()
The elements given here are free from short-period variations, that is, variations whose period is approximately one revolution.
This is in contrast to the osculating elements (those shown, e.g., by the MechJeb Orbit Info window, or the Kerbal Engineer Redux orbital display), which will exhibit strong periodic variations over a revolution.
While short-period variations are eliminated, long-period and secular variations remain in these elements.
In order to express the magnitude of these variations, the elements are given as a range expressed as midpoint±half-width, indicating that the mean element remains within half-width of midpoint over the mission duration.
The following elements are displayed:
- the mean semimajor axis
$a$ ; - the mean eccentricity
$e$ ; - the mean inclination
$i$ ; - the mean longitude of the ascending node
$Ω$ ; - the mean argument of the periapsis
$ω$ .
The precession rate of
Example on a Молния orbit with RSS:
![]()
The ranges of the altitudes of the mean periapsis and mean apoapsis are also shown.
These are not the ranges of the actual lowest altitudes and highest altitudes reached over the course of an orbit; instead those are the ranges of the quantities
Important
These numbers should not be relied on to determine whether the orbit risks reentering or running into terrain; instead the Lowest altitude indicator should be used.
Example on an eccentric lunar orbit in RSS:
![]()
This section is a draft describing a feature which is not yet available. It will be released in Leibniz.
A button
next to the words Mean orbital elements toggles the displaying of graphs. When graphs are shown, a graph of the elements over time is shown to the right of the range of that element for each of
The horizontal range of these graphs is the analysed period, given at the top of the report, starting from the current time.
For
- for
$a$ , the vertical range is$[\min r_{\text{pe}}, \max r_{\text{ap}}]$ ; - for
$h_{\text{pe}}$ , and$h_{\text{ap}}$ , it is$[\min h_{\text{pe}}, \max h_{\text{ap}}]$ .
Example on a frozen low lunar orbit in RSS:
![]()
In addition, two larger graphs are shown: The locus of the eccentricity vector and of the Лидов parameters over the course of the mission duration.
This graph shows the locus of
Examples: the eccentricity vector plots of two low polar lunar orbits about the Moon in RSS, one unstable and one frozen:
![]()
![]()
This graph shows, in red, the locus of the Лидов parameters
-
$c_2 ≔ e^2 (\frac25-\sin^2\ i\ \sin^2\ ω)$ ; -
$c_1 ≔ (1-e^2) \cos^2\ i$ .
It can be used to understand the expected inclination–eccentricity exchange due to third bodies (the von Zeipel–Лидов–古在 mechanism).
Two grids can be shown: the lines of minimum inclination and maximum inclination corresponding to points in
Example: on a stable eccentric lunar orbit in RSS.
![]()
![]()
![]()
Besides describing the general look and feel of the orbit, the elements can be used to determine whether an orbit is stable.
For a stable orbit, the variation of the semimajor axis and inclination will remain small.
Most orbits will experience a precession (long-term drift) of
Example: a medium Earth orbit experiencing both nodal and apsidal precession. The periapsis starts over the southernmost point of the orbit (bottom of the eccentricity vector graph), and over time moves drifts around the orbit with a positive apsidal precession of roughly two degrees per day, to be over the equator on the ascending pass (right), then over the northernmost point of the orbit (top), over the equator on the descending pass (left), coming back south.
![]()
When orbiting an oblate body, the nodal precession can only be eliminated if the orbit is strictly polar.
Example: a low polar Earth orbit. The longitude of the ascending node does not drift, there is no nodal precession. There is a negative apsidal precession, accompanied by a variation in eccentricity.
![]()
It is often interesting to eliminate the apsidal precession and the variation of the eccentricity, as this means that the satellite will fly over the same latitudes at the same height. This is useful for communications satellites on eccentric orbits, such as Молния, in order to keep the apoapsis (where the satellite spends the most time) above the latitudes being serviced. It is also useful for low Earth orbit observation satellites, as it means that the same locations will be imaged in the same conditions: the satellite being at the same altitude, it will have the same field of view.
On a more pragmatic note, curtailing the variation of the eccentricity also means that the periapsis will not change too much, and in particular will not go under the surface: an orbit with constant eccentricity will not wander into the ground over time.
Orbits that have no apsidal precession and roughly constant eccentricity are called frozen.
These can be classified (following the terminology of Ulrich Walter [Wal18]) in type I and type II frozen orbits.
If the inclination is
This property is used by the orbit of the Молния satellites, in order to keep the apoapsis over the northern latitudes that they service.
Example: a Молния orbit. The argument of perigee remains around 270°, so that the apogee remains at the northernmost point of the orbit.
![]()
Note
A frozen orbit is not necessary to use eccentric orbits that require stability in the location of their apsides. QZSS uses a geosynchronous eccentric orbit with an argument of perigee
The other kind of frozen orbit requires a frozen argument of periapsis
Note
The dependence of the frozen eccentricity on the inclination and semimajor axis can be complex; we recommend studying the literature on the subject, and, in practice, experimenting to see which changes to the orbit reduce the drift of the pattern of the eccentricity vector until it is periodic.
In the case of the Earth, with
Both the frozen argument of periapsis and the frozen eccentricity are mean values over the ground track cycle; the mean values provided by the orbit analyser are over a single revolution, and will vary over the course of a ground track cycle. However, in these frozen orbits, the eccentricity vector will trace a periodic path whose period will be that of the ground track cycle; this can be used to find and refine a frozen orbit.
Example 1: a frozen orbit about the Earth.
![]()
Example 2: a frozen orbit about the Moon (Orbit C from [RL06]).
![]()
Example 3: an unstable (not frozen) low polar orbit about the Moon. The eccentricity vector traces a pattern which does not repeat, but instead drifts away.
![]()
The orbit of satellite under the influence of a third body orbiting roughly in the equatorial plane, such as a satellite of the Moon perturbed by the Earth, a satellite of Mercury perturbed by the Sun, etc., experiences a periodic exchange between its inclination and its eccentricity: the eccentricity increases as the inclination decreases, up to a maximum of eccentricity and minimum of inclination, and vice-versa. This is known as the von Zeipel–Лидов–古在 mechanism. The Лидов parameters can be used to describe this mechanism. When the orbit is only perturbed by a third body in the equatorial plane of the primary, these parameters remain constant.
Note
In the following, the statements about the behaviour of an orbit are all made under the assumption that there are no perturbations other than the third body. In addition, the orbits are taken to be prograde (
The space of Лидов parameters consists of two regions, separated by a the vertical axis
For an orbit whose parameters are on the left, with
The value of the Лидов parameters determines the amplitude of the eccentricity–inclination exchange; given values of
These lines also allow us to identify some important parts of the graph:
| Name | Description | Region |
|---|---|---|
| Both the |
![]() |
|
| The |
![]() |
|
| On the curved boundary on the left of the graph, |
![]() |
|
| The vertical line |
![]() |
|
| The top part of the |
![]() |
Tip
In practice, when orbiting an oblate body at low altitudes, the effects of the gravitational field of the primary average out those of the von Zeipel– Лидов–古在 mechanism. Low polar orbits can therefore be stable, as shown in the section on Type II frozen orbits.
Caution
When using the stock KSP solar system, there is no oblateness, so the von Zeipel–Лидов–古在 mechanism does not get averaged out; all polar orbits, no matter how low, eventually crash.
Note
When the perturbing body does not lie in the equatorial plane, when the primary has a complex gravitational field, or when there are additional perturbations, the Лидов parameters do not remain exactly constant; however, so long as they roughly remain in the same area of the graph, they can indicate the long-term impact of third-body effects.
Example 1: a stable eccentric lunar orbit, Orbit B from [RL06]; the parameters lie on
$DE$ , so this orbit does not experience eccentricity-inclination exchange under the influence of the Earth; it can be expected to remain at an inclination of 50° and an eccentricity of 0.5.![]()
![]()
Example 2: A highly inclined orbit about Mercury with an initial eccentricity of 0.5. It is doomed.
![]()
Example 3: An orbit about Venus with an initial eccentricity of 0.5 and an initial inclination of 45°. It experiences a periodic eccentricity-inclination exchange with apsidal precession.
![]()
Example 4: Two high lunar orbits, both exhibiting a periodic eccentricity-inclination exchange. The first one has
$c_2<0$ and has no apsidal precession, the second has$c_2>0$ and exhibits apsidal precession.
$c_2<0$ $c_2>0$
The treatment of that subject in the orbit analysis tooling, and in particular the notation of the recurrence triple, is heavily inspired by Michel Capderou (2012), Satellites : de Kepler au GPS [Cap12]. The figures in this section are produced using Capderou's tool Ἰξίων.
In many cases, a satellite orbit is designed to have a repeating ground track, i.e., to be periodic in the surface frame.
The most obvious example of this situation is a geosynchronous orbit, whose orbit traces a single closed loop on the surface of the Earth, or, in the geostationary case, a single point on the equator.
![]() |
![]() |
|---|
Semisynchronous orbits, e.g., Молния or GPS, are also an example; these make two nodal revolutions before the ground track returns to its starting point.
| Молния | GPS |
|---|---|
|
|
Many satellites however have more complex recurrence relations; for instance the ground track of ГЛОНАСС satellites repeats every 17 revolutions, which corresponds to 8 days; the ground track of Galileo satellites repeats every 17 revolutions, which corresponds to 10 days.
![]() |
![]() |
|---|
Low Earth Orbit satellites also tend to have a ground track recurrence, especially when they are dedicated to Earth observation. For instance, the ground track of Sentinel-3A repeats every 385 revolutions, which corresponds to 27 days. A whole-Earth map of this ground track over the whole cycle would be unreadable: it traces a tight net around the planet. We show instead the whole-Earth ground track over a couple of days, and the ground track over Western Europe over one ground track cycle.
![]() |
![]() |
|---|
The orbital analysis tool attempts to determine a cycle which is a good match to the current orbit. While this works reasonably well once the satellite is on the intended orbit, the tool cannot infer your intentions; if you would like to use it to align your orbit to a particular recurrence cycle, you should uncheck the Auto-detect box, and type in the appropriate numbers of revolutions and days per cycle.
The recurrence triple consists of three numbers
This means that orbits that have similar periods will have similar values of
If
The equatorial shift is the angle, measured on the surface, between successive crossings of the equator; it measures how much the orbit shifts from one ascending pass to the next (as seen from an observer on the ground). The corresponding distance along the equator is given in parentheses. On planets with prograde rotation, the equatorial shift is almost always negative, i.e., westwards.
| In this map, we can see an equatorial shift of -25°.2, or 2810 km: the ground track starts north of New Guinea, and, one revolution later, is 2810 km west of its starting point, over Borneo. | ![]() |
The grid interval is the angle, measured on the surface, between neighbouring tracks on the equator; note that neighbouring tracks may be many revolutions apart. As for the equatorial shift, the corresponding distance along the equator is given in parentheses.
| In this map, we can see a grid interval of 0°.93, or 104 km: the ground track traces a grid whose spacing on the equator is 104 km; over the course of 27 days, the satellite will fly over locations 104 km apart along the equator. | ![]() |
The grid interval is important for observation satellites: the instrument swath (the extent of the surface which is seen by the instrument) must be wider than the grid interval in order for the whole surface to be observed.
The subcycle is the number of days after which the ground track comes back to within one grid interval of its starting point.
| In this map, we can see the ground track of Sentinel-3A over one subcycle (4 days); the last ascending pass (in blue) is one grid interval away from the first one (in red), north of New Guinea. All ascending passes before that are further away. | ![]() |
The subcycle measures how quickly the satellite will come “close” (as defined by the grid interval) to any point on the surface; a short subcycle allows the satellite to quickly observe any given target; a long subcycle may require waiting a full ground track cycle before an observation can be made.
The properties of the recurrence described in the preceding section are purely theoretical. The analysis of the equatorial crossings of the actual orbit describes how well that orbit follows the nominal recurrence.
The passes are numbered as follows: on the recurrence grid, the ascending pass whose equatorial crossing has the smallest longitude East of the reference meridian is pass 1; subsequent passes are numbered chronologically, with revolution n comprising ascending pass 2n-1 and descending pass 2n: odd passes are ascending, even passes descending.
The longitude of ascending pass differs from the previous one by the equatorial shift.
The longitudes of the equatorial crossings of the ascending and descending passes are given as ranges of longitudes on the equator. The midpoint describes where the recurrence grid is situated on the planet; the width describes how much the satellite deviates from the nominal recurrence grid. This deviation is also indicated as a distance measured along the equator.
On a well-kept orbit, this deviation should be much smaller than the grid interval.
(Not yet documented)
Principia for Kerbal Space Program. For support, join the IRC, or go to the KSP-RO discord server and go to the respective channel.
- Leibniz
- Lehmer
- Legendre
- Лефшец
- Lebesgue
- Laurent
- Laplace
- Landau
- Lánczos
- Lamé
- Lambert
- Laguerre
- Lagrange
- Lagny
- خیام
- خوارزمی
- Kuratowski
- Kummer
- Крылов
- Kronecker
- Колмогоров
- von Koch
- Klein
- Kleene
- 𒁹𒆠𒁷𒉡
- کاشانی
- Καραθεοδωρή
- Канторович
- 掛谷
- Julia
- Jordan
- 賈憲
- 𓇹𓄟𓋴𓏲
- Jensen
- Jacobi
- 岩澤
- 伊藤
- ابن الهيثم
- Ὑπατία
- Hurwitz
- Householder
- Horner
- l’Hôpital
- Ἱπποκράτης
- Ἱππίας
- Ἵππασος
- Ἵππαρχος
- Hilbert
- Hesse
- Ἥρων
- Hermite
- Heine
- Hausdorff
- हरीश चंद्र
- Hardy
- Hamilton
- Halley
- Hadamard
- Haar
- Grothendieck
- Grossmann
- Gröbner
- Green
- Grassmann
- Goldbach
- Gödel
- Germain
- Гельфонд
- Гельфанд
- Gauss
- Gateaux
- Galois
- Gallai
- Galileo
- Fuchs
- Fubini
- Frobenius
- Frenet
- Frege
- Fréchet
- פרנקל
- Fourier
- Fibonacci
- del Ferro
- Ferrari
- Fermat
- Fatou
- Fáry
- Fano
- Euler
- Εὐκλείδης
- Εὔδοξος
- Erdős
- Ἐρατοσθένης
- Διόφαντος
- Descartes
- Desargues
- Δημόκριτος
- Dedekind
- Darboux
- Cramer
- Coxeter
- Cohen
- Clifford
- Christoffel
- 陈景润
- Chasles
- Cesàro
- Чебышёв
- Cayley
- Cauchy
- Catalan
- Cartan
- Cardano
- Cantor
- بوژگانی
- Burnside
- Буняковский
- Buffon
- Brouwer
- Bourbaki
- Borel
- Bolzano
- Bessel
- Бернштейн
- Bernoulli
- Banach
- Agnesi
- Ackermann
- Abel















