Sources reviewed

aero

Aerospace engineering in Python — from sea-level air to low Earth orbit, with live NASA, ESA, ISS and ISRO data one call away.

Calculators
5
Data clients
4
Explorer endpoints
31
API entries
65
Circular orbit at 420 km — about the ISS's altitude
Orbital speed
7.66 km/s
Period
92.97 min
Orbits per day
15.49

Computed in your browser with the aero.orbital formulas.

What changed

Latest from the agencies

Space-data services move, retire and change format. These are the changes aero now follows, reviewed against each provider's documentation or source repository on 12 November 2026.

  1. Heads-up CelesTrak

    The satellite catalogue passed 99,999

    New objects now receive six-digit catalogue numbers, and CelesTrak's TLE output leaves them out. celestrak_elements(), station_elements() and navic_elements() request JSON (OMM) by default, which carries every object.

  2. Retired NASA

    Mars Rover Photos API retired

    The Mars Rover Photos API is no longer listed on api.nasa.gov, and its source repository is archived. mars_rover_photos() now emits a DeprecationWarning; find rover imagery with image_search() instead.

  3. Changed NASA

    TechPort's API moved to techport.nasa.gov

    techport_projects() and techport_project() now call techport.nasa.gov/api. Project listings require updated_since; set TECHPORT_API_TOKEN or pass techport_token to send a bearer token.

  4. New NASA · ESA

    Three new keyless data calls

    eonet_events() lists natural events from NASA EONET, image_search() searches the NASA Image and Video Library, and neocc_query() runs ADQL on ESA NEOCC's TAP service.

  5. Changed Launch Library 2

    ISRO launches now use Launch Library 2.3.0

    launches() and agency() call version 2.3.0 and its /launches/previous/ and /launches/upcoming/ routes. Anonymous access is limited to 15 requests per hour per IP address.

  6. Changed ESA

    NEOCC risk list via automated download

    neocc_risk_list() fetches the daily risk list from NEOCC's automated-access service and returns it as published: pipe-delimited text. open_data_search() and open_data_dataset() are deprecated, because data.esa.int is now the ESA Data Discovery Portal and documents no public CKAN API.

  7. Heads-up ISS

    Open Notify is HTTP-only and unmaintained

    Open Notify has not changed since 2021 and serves plain HTTP only, so browsers block it on HTTPS pages like this one, and its crew list is maintained by hand. The ISS explorer now defaults to “Where the ISS at?”, which serves HTTPS.

  8. Archival NASA

    InSight Mars weather is archival

    api.nasa.gov still lists the InSight weather feed, last updated in March 2021, and the mission ended in December 2022. Treat insight_weather() as historical data with gaps.

  9. Community ISRO

    ISRO catalogues come from a community project

    spacecrafts(), launchers(), customer_satellites() and centres() read the community-run isro.vercel.app API, last updated in January 2025. For current launches use launches(), backed by Launch Library 2.

The library

Modules

Five calculation modules implement textbook formulas with input validation. Four data clients wrap public space-agency services behind one consistent interface.

Run the numbers

Interactive calculators

These calculators run the library's formulas in your browser, with the same equations and validation as the Python functions, so you can sanity-check values before you write code.

Standard atmosphere

aero.atmosphere

Lift & drag

aero.aerodynamics

Circular orbit

aero.orbital

Rocket stage

aero.rocketry

Live data

Data explorer

Pick an endpoint to see the exact request the Python client sends, then send it live from your browser or copy the equivalent aero snippet. Services that block cross-origin calls fail in the browser; you can then retry once through a public read-only CORS proxy, which sends the request URL to that third party. The retry is never offered when the request carries your own API key.

GET

ResponseReady

GET

ResponseReady

GET

ResponseReady

GET

ResponseReady

Live requests run from your browser, so some services refuse them. The Python clients are not subject to that restriction.

Status board

Sources & status

Where each client gets its data, what it needs and what to watch for. Every client accepts an injectable requests.Session and timeout, and raises a module-specific error on failure.

NASA aero.nasa

from aero import esa, iss, isro, nasa

nasa.NASAClient().apod()                          # Astronomy Picture of the Day, no key
nasa.NASAClient().image_search(query="artemis")   # NASA Image and Video Library
esa.ESAClient().neocc_risk_list()                 # NEOCC risk list, pipe-delimited text
iss.ISSClient().satellite_position()              # ISS state vector over HTTPS
isro.ISROClient().launches(limit=5)               # Recent ISRO launches, Launch Library 2

Reference

API reference

Every public function and client method, generated from the package's signatures and docstrings. Search finds any entry by name — press Ctrl K.

aero.atmosphere

International Standard Atmosphere (ISA) from sea level to 20 km.

4 functions in aero.atmosphere
temperature(altitude: float) -> float
Return the ISA temperature (K) at the given geopotential altitude (m).
pressure(altitude: float) -> float
Return the ISA pressure (Pa) at the given geopotential altitude (m).
density(altitude: float) -> float
Return the ISA density (kg/m^3) at the given geopotential altitude (m).
speed_of_sound(altitude: float) -> float
Return the local speed of sound (m/s) at the given altitude (m).

aero.aerodynamics

Dynamic pressure, lift, drag, Mach and Reynolds numbers.

6 functions in aero.aerodynamics
dynamic_pressure(rho: float, velocity: float) -> float
Return dynamic pressure q = 1/2 * rho * V^2 (Pa).
lift(rho: float, velocity: float, area: float, cl: float) -> float
Return lift force (N) for given density, velocity, wing area and CL.
drag(rho: float, velocity: float, area: float, cd: float) -> float
Return drag force (N) for given density, velocity, wing area and CD.
lift_to_drag_ratio(cl: float, cd: float) -> float
Return the lift-to-drag ratio L/D for given coefficients.
mach_number(velocity: float, altitude: float = 0.0) -> float
Return the Mach number for a velocity (m/s) at a given altitude (m).
reynolds_number(rho: float, velocity: float, length: float, dynamic_viscosity: float) -> float
Return the Reynolds number Re = rho * V * L / mu.

aero.orbital

Two-body orbital velocity, period and escape velocity.

4 functions in aero.orbital
orbital_velocity(mu: float, radius: float, semi_major_axis: float) -> float
Return orbital speed (m/s) via the vis-viva equation.
circular_orbital_velocity(mu: float, radius: float) -> float
Return the speed (m/s) required for a circular orbit of given radius.
orbital_period(mu: float, semi_major_axis: float) -> float
Return the orbital period (s) for a given semi-major axis (m).
escape_velocity(mu: float, radius: float) -> float
Return the escape velocity (m/s) at a given radius (m).

aero.rocketry

Rocket equation, propellant sizing, thrust and staging.

11 functions in aero.rocketry
exhaust_velocity(specific_impulse: float, g0: float = 9.80665) -> float
Return effective exhaust velocity (m/s) for a specific impulse (s).
specific_impulse(exhaust_speed: float, g0: float = 9.80665) -> float
Return specific impulse (s) for an effective exhaust velocity (m/s).
mass_ratio(initial_mass: float, final_mass: float) -> float
Return the mass ratio m0 / mf of a rocket or stage.
delta_v(exhaust_speed: float, initial_mass: float, final_mass: float) -> float
Return the ideal delta-v (m/s) from the Tsiolkovsky rocket equation.
propellant_mass(exhaust_speed: float, initial_mass: float, required_delta_v: float) -> float
Return the propellant mass (kg) needed for required_delta_v (m/s).
thrust(mass_flow_rate: float, exhaust_speed: float) -> float
Return thrust (N) produced by a mass flow rate (kg/s) of propellant.
mass_flow_rate(thrust_force: float, exhaust_speed: float) -> float
Return the propellant mass flow rate (kg/s) for a given thrust (N).
burn_time(propellant: float, flow_rate: float) -> float
Return the burn time (s) for a propellant mass (kg) and flow rate (kg/s).
thrust_to_weight_ratio(thrust_force: float, mass: float, gravity: float = 9.80665) -> float
Return the (dimensionless) thrust-to-weight ratio of a vehicle.
stage_delta_v(stages: Sequence[Tuple[float, float, float]], payload_mass: float = 0.0) -> float
Return the total ideal delta-v (m/s) of a serially staged rocket.
total_delta_v(delta_vs: Iterable[float]) -> float
Return the sum of a delta-v budget (m/s), rejecting negative entries.

aero.navigation

Great-circle distance, bearings and waypoints.

7 functions in aero.navigation
central_angle(lat1: float, lon1: float, lat2: float, lon2: float) -> float
Return the angle (radians) subtended at the center of the sphere.
great_circle_distance(lat1: float, lon1: float, lat2: float, lon2: float, radius: float = 6371008.8) -> float
Return the shortest surface distance (m) between two positions.
initial_bearing(lat1: float, lon1: float, lat2: float, lon2: float) -> float
Return the initial course (degrees from true north) of the shortest path.
final_bearing(lat1: float, lon1: float, lat2: float, lon2: float) -> float
Return the course (degrees from true north) on arrival at the second point.
destination_point(lat: float, lon: float, bearing: float, distance: float, radius: float = 6371008.8) -> Tuple[float, float]
Return the position reached by travelling along a great circle.
intermediate_point(lat1: float, lon1: float, lat2: float, lon2: float, fraction: float) -> Tuple[float, float]
Return the point a given fraction along the shortest path.
shortest_path(lat1: float, lon1: float, lat2: float, lon2: float, segments: int = 16) -> List[Tuple[float, float]]
Return points sampling the shortest path between two positions.

aero.nasa

NASA Open APIs, APOD, EONET, the Image Library, TechPort and the Exoplanet Archive.

NASAClient(api_key: Optional[str] = None, session: Optional[requests.Session] = None, timeout: float = 30, techport_token: Optional[str] = None) raises NASAAPIError

12 methods in aero.nasa
apod(date: Optional[DateLike] = None, start_date: Optional[DateLike] = None, end_date: Optional[DateLike] = None) -> Any Updated
Return Astronomy Picture of the Day entries from NASA Science.
mars_rover_photos(rover: str = 'curiosity', sol: Optional[int] = None, earth_date: Optional[str] = None, camera: Optional[str] = None, page: Optional[int] = None) -> Any Deprecated
Return Mars Rover photos for the given rover and sol/earth_date.
neo_feed(start_date: Optional[str] = None, end_date: Optional[str] = None) -> Any
Return near-Earth objects within the given date range (max 7 days).
neo_lookup(asteroid_id: str) -> Any
Return details for a specific near-Earth object by its NASA JPL ID.
donki_notifications(start_date: Optional[str] = None, end_date: Optional[str] = None, notification_type: str = 'all') -> Any
Return DONKI space weather notifications.
epic_natural_images(date: Optional[str] = None) -> Any
Return EPIC natural-color Earth images, optionally for a date.
eonet_events(status: str = 'open', limit: Optional[int] = None, days: Optional[int] = None, category: Optional[str] = None) -> Any New
Return natural events (wildfires, storms, volcanoes...) from EONET.
image_search(query: Optional[str] = None, media_type: Optional[str] = None, year_start: Optional[int] = None, year_end: Optional[int] = None, page: Optional[int] = None, page_size: Optional[int] = None) -> Any New
Search the NASA Image and Video Library (images.nasa.gov).
insight_weather() -> Any Archival
Return the InSight Mars weather feed.
techport_projects(updated_since: str) -> Any Updated
Return IDs of TechPort projects updated since a date.
techport_project(project_id: int) -> Any Updated
Return details for a specific NASA TechPort project.
exoplanets(query: str = 'select * from ps', fmt: str = 'json') -> Any
Query NASA's Exoplanet Archive using the TAP ADQL/SQL-like syntax.

aero.esa

Copernicus Sentinel products, the Gaia Archive and NEOCC near-Earth object data.

ESAClient(session: Optional[requests.Session] = None, timeout: float = 30) raises ESAAPIError

6 methods in aero.esa
open_data_search(query: str = '', rows: Optional[int] = None) -> Any Deprecated
Search data.esa.int with a CKAN-style package_search request.
open_data_dataset(dataset_id: str) -> Any Deprecated
Fetch data.esa.int metadata with a CKAN-style package_show request.
copernicus_products(collection: Optional[str] = None, filter_: Optional[str] = None, top: Optional[int] = None, orderby: Optional[str] = None) -> Any
Search Copernicus Sentinel satellite products.
gaia_query(query: str = 'select top 10 * from gaiadr3.gaia_source', fmt: str = 'json') -> Any
Query the Gaia star catalogue archive using ADQL.
neocc_risk_list() -> str Updated
Return ESA NEOCC's current near-Earth object risk list.
neocc_query(query: str, fmt: str = 'json') -> Any New
Run an ADQL query on the ESA NEOCC TAP server.

aero.iss

ISS state vectors, TLEs, CelesTrak elements and Open Notify crew data.

ISSClient(session: Optional[requests.Session] = None, timeout: float = 30) raises ISSAPIError

7 methods in aero.iss
current_location() -> Any HTTP only
Return the ISS's current latitude/longitude from Open Notify.
people_in_space() -> Any HTTP only
Return the people currently in space and their spacecraft.
satellite_position(norad_id: int = 25544, units: Optional[str] = None) -> Any
Return the current state vector for a tracked satellite.
satellite_positions(timestamps: Iterable[Union[int, str]], norad_id: int = 25544, units: Optional[str] = None) -> Any
Return state vectors for up to 10 Unix timestamps.
tle(norad_id: int = 25544) -> Any
Return the latest two-line element set for a tracked satellite.
celestrak_elements(norad_id: Optional[int] = 25544, group: Optional[str] = None, fmt: str = 'json') -> Any
Return orbital elements from CelesTrak's GP service.
station_elements(fmt: str = 'json') -> Any
Return orbital elements for CelesTrak's stations group.

aero.isro

ISRO catalogues, Launch Library 2 launches and NavIC elements.

ISROClient(session: Optional[requests.Session] = None, timeout: float = 30) raises ISROAPIError

8 methods in aero.isro
spacecrafts() -> Any
Return the catalogue of ISRO spacecraft and satellites.
launchers() -> Any
Return the catalogue of ISRO launch vehicles (SLV, PSLV, GSLV...).
customer_satellites() -> Any
Return foreign customer satellites launched by ISRO.
centres() -> Any
Return ISRO centres and units with their locations.
launches(upcoming: bool = False, search: Optional[str] = None, limit: Optional[int] = None, offset: Optional[int] = None) -> Any Updated
Return ISRO launches from Launch Library 2.
agency() -> Any Updated
Return Launch Library 2 agency metadata for ISRO.
celestrak_elements(norad_id: Optional[int] = None, group: Optional[str] = None, name: Optional[str] = None, fmt: str = 'json') -> Any
Return orbital elements for ISRO spacecraft from CelesTrak's GP service.
navic_elements(fmt: str = 'json') -> Any
Return orbital elements for the NavIC (IRNSS) constellation.

Get started

Install & use

aero needs Python 3.8 or newer and requests. Install it straight from GitHub; the aero name on PyPI belongs to an unrelated project.

  1. Install from GitHub

    pip install git+https://github.com/charles2ke/aero.git
  2. Or work from a clone

    git clone https://github.com/charles2ke/aero.git
    cd aero
    pip install -e .
  3. Calculate

    from aero import aerodynamics, atmosphere, orbital
    from aero import navigation, rocketry
    
    rho = atmosphere.density(5000)       # kg/m³ at 5 km
    lift = aerodynamics.lift(rho=rho, velocity=120.0,
                             area=16.2, cl=0.4)
    v = orbital.circular_orbital_velocity(
        orbital.EARTH_MU, orbital.EARTH_RADIUS + 420_000)
    dv = rocketry.delta_v(rocketry.exhaust_velocity(300),
                          5500, 1500)
    d = navigation.great_circle_distance(
        40.6413, -73.7781, 51.47, -0.4543)  # JFK → LHR
  4. Run the tests

    pip install pytest
    pytest
    
    # Optional browser tests for this website
    pip install playwright
    playwright install chromium

Search aero