From 4c4e7052ba9aabd1ee5e1f7cf352aeab5ae9c04c Mon Sep 17 00:00:00 2001 From: Ashley Childress Date: Thu, 10 Sep 2026 20:53:54 -0400 Subject: [PATCH] docs: describe the release assets the daily build actually publishes - add the joined registry, and note that the FAA CSV it supersedes still ships - document basic-ac-db.json.gz and mictronics-db.zip, which have been published for months without appearing in the README - point at NOTICE for the redistribution terms that travel with the data Generated-by: Claude Opus 5 --- README.md | 20 ++++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 8c8eb94..b98a250 100644 --- a/README.md +++ b/README.md @@ -26,13 +26,29 @@ df = pd.read_csv(url) df ``` ![](docs/images/df_adsb_example_0.png) -- **openairframes_faa.csv** - All [FAA registration data](https://www.faa.gov/licenses_certificates/aircraft_certification/aircraft_registry/releasable_aircraft_download) from 2023-08-16 to present (~260 MB) +- **openairframes_registry.csv** + Every national registry in one table, one row per registration record, with a `source` + column naming the registry it came from. Currently the FAA (United States) and Transport + Canada. Identifier columns (`transponder_code_hex`, `registration_number`, + `openairframes_id`) lead the table and are populated for every source. +- **openairframes_faa.csv** + All [FAA registration data](https://www.faa.gov/licenses_certificates/aircraft_certification/aircraft_registry/releasable_aircraft_download) from 2023-08-16 to present (~275 MB). + Superseded by `openairframes_registry.csv`; still published so existing consumers keep working. - **ReleasableAircraft_{date}.zip** A daily snapshot of the FAA database, which updates at **05:30 UTC** +- **basic-ac-db.json.gz** + [ADS-B Exchange](https://www.adsbexchange.com/) basic aircraft database, republished unmodified. + +- **mictronics-db.zip** + [Mictronics](https://www.mictronics.de/aircraft-database/) aircraft database, republished + unmodified. Best effort — the release ships without it when the source is unavailable. + +Redistribution terms for the underlying sources travel with the release in **NOTICE**. Some +registries permit redistribution only on condition that specific notices reach you with the data. + --- ## For Contributors