aero.atmosphere
International Standard Atmosphere: temperature, pressure, density and speed of sound up to 20 km.
Sources reviewed
Aerospace engineering in Python — from sea-level air to low Earth orbit, with live NASA, ESA, ISS and ISRO data one call away.
Computed in your browser with the aero.orbital formulas.
What changed
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.
ESA has scheduled Gaia DR4 for 2 December 2026. Until its tables appear in the Gaia Archive, gaia_query() keeps defaulting to gaiadr3.gaia_source; pass your own ADQL to query DR4 once it is live.
NASA moved the Astronomy Picture of the Day API to science.nasa.gov in September 2026. It needs no API key, and apod() now calls it: hdurl is the image and url the APOD post. The legacy api.nasa.gov/planetary/apod route goes offline on 1 December 2026.
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.
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.
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.
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.
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.
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.
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.
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.
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
Five calculation modules implement textbook formulas with input validation. Four data clients wrap public space-agency services behind one consistent interface.
aero.atmosphereInternational Standard Atmosphere: temperature, pressure, density and speed of sound up to 20 km.
aero.aerodynamicsDynamic pressure, lift, drag, lift-to-drag ratio, Mach number and Reynolds number.
Try it with aero.aerodynamics Reference for aero.aerodynamics
aero.orbitalVis-viva and circular orbital velocity, orbital period and escape velocity.
aero.rocketryTsiolkovsky rocket equation, mass ratios, propellant sizing, specific impulse, thrust, burn time, thrust-to-weight and staging.
aero.navigationGreat-circle navigation: shortest-path distance, initial and final bearings, destination and intermediate points.
aero.nasaAPOD, NeoWs, DONKI, EPIC, EONET natural events, the Image and Video Library, TechPort and the Exoplanet Archive.
aero.esaCopernicus Sentinel products, the Gaia Archive, and NEOCC near-Earth object data including TAP queries.
aero.iss“Where the ISS at?” state vectors and TLEs, CelesTrak OMM elements, and Open Notify crew data.
aero.isroISRO spacecraft, launchers and centres, Launch Library 2 launches and NavIC orbital elements.
Run the numbers
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.
Live data
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.
Live requests run from your browser, so some services refuse them. The Python clients are not subject to that restriction.
Status board
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.
aero.nasaapi.nasa.gov documentation
NeoWs, DONKI, EPIC and InSight. Uses DEMO_KEY unless you set NASA_API_KEY.
science.nasa.gov APOD documentation
Astronomy Picture of the Day, served from /wp-json/wp/v2/apod-basic.
eonet.gsfc.nasa.gov documentation
EONET v3 natural events: wildfires, storms, volcanoes and more.
images-api.nasa.gov documentation
NASA Image and Video Library search.
techport.nasa.gov documentation
TechPort technology projects. Sends TECHPORT_API_TOKEN as a bearer token when set.
exoplanetarchive.ipac.caltech.edu documentation
NASA Exoplanet Archive TAP queries.
aero.esacatalogue.dataspace.copernicus.eu documentation
Copernicus Data Space Ecosystem OData catalogue of Sentinel products.
gea.esac.esa.int documentation
Gaia Archive TAP. DR3 is the latest release until DR4 on 2 December 2026.
neo.ssa.esa.int documentation
NEOCC risk list as pipe-delimited text, plus ADQL on dachs.neo.s2p.esa.int.
data.esa.int portal
ESA Data Discovery Portal. The CKAN-style calls in aero are deprecated.
aero.issapi.wheretheiss.at documentation
State vectors with altitude and velocity, positions at timestamps, and TLEs.
celestrak.org documentation
GP orbital elements, JSON (OMM) by default for six-digit catalogue numbers.
api.open-notify.org source repository
People in space and a basic ISS position. Plain HTTP only, unmaintained since 2021.
aero.isroll.thespacedevs.com documentation
Launch Library 2.3.0: past and upcoming ISRO launches and agency details.
isro.vercel.app source repository
Community catalogue of spacecraft, launchers, customer satellites and centres.
celestrak.org documentation for NavIC elements
NavIC (IRNSS) and other GNSS orbital elements.
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
Every public function and client method, generated from the package's signatures and docstrings. Search finds any entry by name — press Ctrl K.
aero.atmosphereInternational Standard Atmosphere (ISA) from sea level to 20 km.
temperature(altitude: float) -> floatpressure(altitude: float) -> floatdensity(altitude: float) -> floatspeed_of_sound(altitude: float) -> floataero.aerodynamicsDynamic pressure, lift, drag, Mach and Reynolds numbers.
dynamic_pressure(rho: float, velocity: float) -> floatlift(rho: float, velocity: float, area: float, cl: float) -> floatdrag(rho: float, velocity: float, area: float, cd: float) -> floatlift_to_drag_ratio(cl: float, cd: float) -> floatmach_number(velocity: float, altitude: float = 0.0) -> floatreynolds_number(rho: float, velocity: float, length: float, dynamic_viscosity: float) -> floataero.orbitalTwo-body orbital velocity, period and escape velocity.
orbital_velocity(mu: float, radius: float, semi_major_axis: float) -> floatcircular_orbital_velocity(mu: float, radius: float) -> floatorbital_period(mu: float, semi_major_axis: float) -> floatescape_velocity(mu: float, radius: float) -> floataero.rocketryRocket equation, propellant sizing, thrust and staging.
exhaust_velocity(specific_impulse: float, g0: float = 9.80665) -> floatspecific_impulse(exhaust_speed: float, g0: float = 9.80665) -> floatmass_ratio(initial_mass: float, final_mass: float) -> floatdelta_v(exhaust_speed: float, initial_mass: float, final_mass: float) -> floatpropellant_mass(exhaust_speed: float, initial_mass: float, required_delta_v: float) -> floatthrust(mass_flow_rate: float, exhaust_speed: float) -> floatmass_flow_rate(thrust_force: float, exhaust_speed: float) -> floatburn_time(propellant: float, flow_rate: float) -> floatthrust_to_weight_ratio(thrust_force: float, mass: float, gravity: float = 9.80665) -> floatstage_delta_v(stages: Sequence[Tuple[float, float, float]], payload_mass: float = 0.0) -> floattotal_delta_v(delta_vs: Iterable[float]) -> floataero.navigationGreat-circle distance, bearings and waypoints.
aero.nasaNASA 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
apod(date: Optional[DateLike] = None, start_date: Optional[DateLike] = None, end_date: Optional[DateLike] = None) -> Any Updatedmars_rover_photos(rover: str = 'curiosity', sol: Optional[int] = None, earth_date: Optional[str] = None, camera: Optional[str] = None, page: Optional[int] = None) -> Any Deprecatedneo_feed(start_date: Optional[str] = None, end_date: Optional[str] = None) -> Anyneo_lookup(asteroid_id: str) -> Anydonki_notifications(start_date: Optional[str] = None, end_date: Optional[str] = None, notification_type: str = 'all') -> Anyepic_natural_images(date: Optional[str] = None) -> Anyeonet_events(status: str = 'open', limit: Optional[int] = None, days: Optional[int] = None, category: Optional[str] = None) -> Any Newimage_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 Newinsight_weather() -> Any Archivaltechport_projects(updated_since: str) -> Any Updatedtechport_project(project_id: int) -> Any Updatedexoplanets(query: str = 'select * from ps', fmt: str = 'json') -> Anyaero.esaCopernicus Sentinel products, the Gaia Archive and NEOCC near-Earth object data.
ESAClient(session: Optional[requests.Session] = None, timeout: float = 30) raises ESAAPIError
open_data_search(query: str = '', rows: Optional[int] = None) -> Any Deprecatedopen_data_dataset(dataset_id: str) -> Any Deprecatedcopernicus_products(collection: Optional[str] = None, filter_: Optional[str] = None, top: Optional[int] = None, orderby: Optional[str] = None) -> Anygaia_query(query: str = 'select top 10 * from gaiadr3.gaia_source', fmt: str = 'json') -> Anyneocc_risk_list() -> str Updatedneocc_query(query: str, fmt: str = 'json') -> Any Newaero.issISS state vectors, TLEs, CelesTrak elements and Open Notify crew data.
ISSClient(session: Optional[requests.Session] = None, timeout: float = 30) raises ISSAPIError
current_location() -> Any HTTP onlypeople_in_space() -> Any HTTP onlysatellite_position(norad_id: int = 25544, units: Optional[str] = None) -> Anysatellite_positions(timestamps: Iterable[Union[int, str]], norad_id: int = 25544, units: Optional[str] = None) -> Anytle(norad_id: int = 25544) -> Anycelestrak_elements(norad_id: Optional[int] = 25544, group: Optional[str] = None, fmt: str = 'json') -> Anystation_elements(fmt: str = 'json') -> Anyaero.isroISRO catalogues, Launch Library 2 launches and NavIC elements.
ISROClient(session: Optional[requests.Session] = None, timeout: float = 30) raises ISROAPIError
spacecrafts() -> Anylaunchers() -> Anycustomer_satellites() -> Anycentres() -> Anylaunches(upcoming: bool = False, search: Optional[str] = None, limit: Optional[int] = None, offset: Optional[int] = None) -> Any Updatedagency() -> Any Updatedcelestrak_elements(norad_id: Optional[int] = None, group: Optional[str] = None, name: Optional[str] = None, fmt: str = 'json') -> AnyGet started
aero needs Python 3.8 or newer and requests. Install it straight from GitHub; the aero name on PyPI belongs to an unrelated project.
pip install git+https://github.com/charles2ke/aero.git
git clone https://github.com/charles2ke/aero.git
cd aero
pip install -e .
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
pip install pytest
pytest
# Optional browser tests for this website
pip install playwright
playwright install chromium
Opens in a new tab.