3D Space Station Orbit: Kepler Motion, Ground Track and Eclipses

A Blender-built modular station circles the Earth: orbital period, J2 precession, ground track, sunlight and eclipse time from altitude, inclination and sun angle.

Switch to 2D

Presets

Playback

Parameters

Camera

Layers

Quality

Model check

The science

What is modelled

A modular space station in low Earth orbit. The page integrates its motion around an oblate Earth, shows the station's path on a globe and on a ground-track map, and works out when it passes through the Earth's shadow. The station model is a generic ISS-like design (pressurised modules, a long truss, radiators and four solar-array wings that turn to face the Sun); it is not an exact copy of the real station.

Equations

  • Two-body gravity with the Earth's equatorial bulge: a = −μ r / r³ · [1 + 1.5 J2 (R/r)² (1 − 5 z²/r²)] for the x and y components and [3 − 5 z²/r²] for z, with μ = 398600.4 km³/s², R = 6378.137 km and J2 = 1.0826×10−3. The equations are advanced by fourth-order Runge-Kutta steps of at most 8 s.
  • For a circular orbit the speed is v = √(μ/r) and the period T = 2π√(a³/μ); in general v² = μ(2/r − 1/a) (vis-viva), and the specific energy is −μ/(2a). At 420 km this gives 7.66 km/s and 92.9 min, about 15.5 orbits a day.
  • The Earth turns once per sidereal day (ωE = 7.292×10−5 rad/s), so each pass is displaced west by ωE T, about 23 degrees of longitude per orbit.
  • The bulge makes the orbit plane rotate: dΩ/dt = −1.5 J2 n (R/p)² cos i, which is about −5 degrees a day for the ISS orbit (51.6 deg) and positive for retrograde orbits such as sun-synchronous ones (i near 98 deg).
  • Eclipses use a cylindrical shadow. The beta angle β is the angle between the Sun direction and the orbit plane. The fraction of the orbit in shadow is acos(√(h² + 2Rh) / (r cos β)) / π and is zero when β exceeds asin(R/r).
  • The solar arrays track the Sun with a rotation about the truss axis: the array normal is turned to the projection of the Sun direction in the station's plane.

Checks run in the page

  • Energy conservation and return to the starting point over one integrated Kepler period, plus the known ISS period and speed.
  • Node regression measured from 30 integrated orbits with J2 against the secular formula.
  • The eclipse fraction sampled around a full orbit against the closed-form expression for three beta angles.

Honest simplifications

  • The Earth's continents and clouds are a stylised procedural picture, not a map: only the ground-track graph's latitude and longitude are real geometry. The orbit path drawn is the unperturbed ellipse; with J2 on, the real path slowly drifts away from it.
  • No atmospheric drag, no lunar or solar gravity, no re-boost, spherical shadow without penumbra; only J2 is included in the perturbations. The beta angle is set by the slider, so the slow change of the orbit plane relative to the Sun over months is not shown.
  • The station is drawn far larger than true scale so that it can be seen (1 unit = 1000 km; the size slider sets it). It has no moving robot arm, and solar-array tracking uses one angle for all four wings.

What to try

  • Raise the altitude from 420 to 2000 km: the period grows from 93 to 127 minutes and the speed falls.
  • Choose Sun-synchronous dawn-dusk: the beta angle is above its critical value, so there is no eclipse at all; with beta 0 the station spends about 39 percent of every orbit in darkness.
  • Compare the ground tracks of the polar orbit and the 51.6 degree orbit; follow the station with the close camera and watch the arrays turn.
  • Switch J2 off and see the orbit plane stop turning (compare with the node readout).
Loading model...
Loading Blender model...
Ground track (latitude vs longitude)
Circular speed and period vs altitude
Time in the Earth shadow vs sun beta angle
Made with 🟠 Blender · Three.js