Skip to content

Documentation / @interstellar-tools/equations / ballisticEntrySpeed

Function: ballisticEntrySpeed() ​

ts
function ballisticEntrySpeed(
  h: number,
  VE: number,
  gamma: number,
  beta: number,
  rho0: number,
  H: number
): number;

Defined in: entry/ballistic-entry-speed.ts:57

Compute the speed of a ballistic entry at an altitude, with the Allen–Eggers solution.

V(h)=VEexp⁡(−ρ0H2βsin⁡|γ|e−h/H)

Where:

  • VE is the speed at entry (m/s)
  • γ is the flight-path angle, constant along the straight path (rad)
  • β is the ballistic coefficient (kg/m²)
  • ρ0 and H describe an exponential atmosphere, ρ=ρ0e−h/H

Units

  • Inputs: h and H in m, VE in m/s, gamma in radians, beta in kg/m², rho0 in kg/m³.
  • Output: V in m/s.

Notes

  • Assumes drag dominates: no lift, no gravity, and a straight path at a constant angle. That holds well for steep, fast entries of non-lifting bodies.
  • The deceleration at any altitude is ρV2/(2β); its peak is ballisticPeakDeceleration, at ballisticPeakDecelerationAltitude.
  • gamma can be given as negative (descending, the usual convention) or positive: only its size is used.
  • Earth's lower atmosphere is roughly ρ0=1.225 kg/m³ with H≈7.2 km. A single exponential is a rough fit; see the density models in #226.

Parameters ​

ParameterTypeDescription
hnumberAltitude h in m (finite).
VEnumberEntry speed VE in m/s (finite, > 0).
gammanumberFlight-path angle γ in radians (finite, non-zero, within [-π/2, π/2]).
betanumberBallistic coefficient β in kg/m² (finite, > 0).
rho0numberReference density ρ0 in kg/m³ (finite, > 0).
HnumberScale height H in m (finite, > 0).

Returns ​

number

Speed V in m/s.

Throws ​

  • If any input is not a finite number.
  • If VE, beta, rho0 or H is <= 0, or gamma is zero or past vertical.

Example ​

ts
import type { Radians } from '@interstellar-tools/types';

// A 322 kg/m² capsule entering at 11 km/s, 6.5° below horizontal
const v = ballisticEntrySpeed(
  40_000,
  11_000,
  ((-6.5 * Math.PI) / 180) as Radians,
  322,
  1.225,
  7200
);
// v ≈ 6.9 km/s at 40 km

See ​