What the Kepler tab solves The Kepler tab of the Physics Sim hub integrates the ideal planar two-body problem r″ = −μ·r/|r|³ from a periapsis state: the mass starts at distance r_p moving perpendicular to the radius. Three sliders — eccentricity e, periapsis r_p and the gravitational parameter μ = G(m₁+m₂) — cover circles, ellipses, parabolas and hyperbolas. The cards report the orbit type, specific energy, angular momentum, semi-major axis, periapsis and apoapsis, the period, and the residual of the measured orbit against the closed-form conic.
How to run a case 01 Pick a preset. Circular, ellipse e = 0.6, eccentric e = 0.9, parabolic escape e = 1 and hyperbolic e = 1.5 ship as chips. 02 Set e, r_p and μ. The launch speed follows from e alone: v = √(μ(1+e)/r_p). 03 Choose the integrator and resolution. RK4 at 400 steps per period is the default; adaptive RK45 is the fix when the periapsis passage is under-resolved. 04 Read the elements. Type, energy, angular momentum h, a, e, r_p/r_a and the period — the period card shows nothing for open orbits. 05 Check the self-tests. The Kepler-III deviation compares the event-measured period with 2π√(a³/μ), and the conic residual compares the path with r = p/(1+e·cosθ).
Worked example μ = 1, periapsis r_p = 1; only the eccentricity changes, and the launch speed with it:
e
Launch speed
Specific energy ε
h
Semi-major a
r_p / r_a
Period
Conic residual
0
1
−0.5
1
1
1 / 1
6.283185 s
—
0.2
1.095445
−0.4
1.095445
1.25
1 / 1.5
8.781018 s
1.65e-7
1
1.414214
0
1.414214
—
1 / —
—
9.17e-8
2
1.732051
0.5
1.732051
−1
1 / —
—
1.12e-7
At e = 0.2 the simulated period is 8.781019 s against the formula's 8.781018 s — a Kepler-III deviation of 1.77e-8 — and the conserved quantities hold: energy drift 4.81e-8 , angular momentum drift 3.08e-8 . The parabolic and hyperbolic runs have no period card, and their conservation is just as tight: 5.77e-9 and 8.80e-9 energy drift at e = 1 and e = 2, with conic residuals below 1.2e-7 .
Energy is the classifier The vis-viva relation splits the speed into what gravity needs and what the orbit has left. Specific energy ε = v²/2 − μ/r is negative for every bound orbit, exactly zero at escape and positive for a flyby; the same number sets the semi-major axis through a = −μ/(2ε). At r_p = 1, the circular speed √(μ/r_p) = 1 needs ε = −0.5; the escape speed √(2μ/r_p) = 1.414214 is the parabola, where ε = 0 ; anything faster is hyperbolic and leaves forever. Eccentricity follows from h and ε, so the shape is not an independent input — setting e sets the speed, and the engine recovers e from the state.
Limits and what it does not do
Two point masses, one plane. No third-body perturbations, oblateness (J₂), drag, relativity, tidal forces or propulsive burns; the orbit is a perfect conic.
The open-orbit cards stop at the domain boundary. For e ≥ 1 the semi-major axis is negative (hyperbola) or absent (parabola), and the period row is empty by design rather than zero. What it does not do. It does not turn elements into a mission plan or propagate a real ephemeris; for satellite tracking from real elements use the Satellites panel , for a reacting system the E×B tab , and for a drag model the projectile tab .
The trap: escaping is not slowing down Escape does not mean the mass drifts away — at e = 1 it is still fastest at periapsis, 1.414214 , and slows forever after, with the speed approaching zero only in the infinite future. Two more traps sit in the cards. First, a hyperbolic orbit reports a negative semi-major axis, −1 at e = 2; that sign is the convention a = −μ/(2ε), not an error. Second, a tiny eccentricity still means a real orbit, not a circle: at e = 0.2 the radius swings from 1 to 1.5 , a 50% variation, while the shape only looks slightly flattened.
Where it is used Teaching the conic family The four cases differ by one slider and one speed. The energy card reads −0.4 for the bound ellipse, 0 for the parabola and +0.5 for the hyperbola with the same periapsis, and the period card appears only while the orbit returns.
Integrator accuracy near periapsis The hub's integrator trap lives in this tab: RK4 at 400 steps per period closes a long eccentric orbit early, while the conic residual and the amber warning name the fix. Run e = 0.2 and e = 2 under both integrators and watch the residuals separate.
Privacy The orbit integration and the element solver run in your browser; the parameters and trajectories never leave the device.
References
NASA, Basics of Space Flight — Gravity & Mechanics — Kepler's laws, energy and period. science.nasa.gov (访问日期:2026-10-07)
Wikipedia, Kepler's laws of planetary motion — the ellipse and T = 2π√(a³/μ). en.wikipedia.org (访问日期:2026-10-07)
Wikipedia, Vis-viva equation — v² = μ(2/r − 1/a) and escape speed. en.wikipedia.org (访问日期:2026-10-07)
Wikipedia, Conic section — eccentricity and the four orbit types. en.wikipedia.org (访问日期:2026-10-07)
Wikipedia, Specific orbital energy — ε = v²/2 − μ/r and its sign. en.wikipedia.org (访问日期:2026-10-07)
Calculators in this hub
Hand-picked tools, one click away. The mini versions compute live and carry your values into the full calculator.
Sources & review
Reviewed by CalcX Editorial Team
Updated 2026-10-07