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.
Where:
is the speed at entry (m/s) is the flight-path angle, constant along the straight path (rad) is the ballistic coefficient (kg/m²) and describe an exponential atmosphere,
Units
- Inputs:
handHin m,VEin m/s,gammain radians,betain kg/m²,rho0in kg/m³. - Output:
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
; its peak is ballisticPeakDeceleration, at ballisticPeakDecelerationAltitude. gammacan be given as negative (descending, the usual convention) or positive: only its size is used.- Earth's lower atmosphere is roughly
kg/m³ with km. A single exponential is a rough fit; see the density models in #226.
Parameters
| Parameter | Type | Description |
|---|---|---|
h | number | Altitude |
VE | number | Entry speed |
gamma | number | Flight-path angle |
beta | number | Ballistic coefficient |
rho0 | number | Reference density |
H | number | Scale height |
Returns
number
Speed
Throws
- If any input is not a finite number.
- If
VE,beta,rho0orHis<= 0, orgammais 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