How urbanairproject/nwp_demo_data works
UrbanAir NWP is a demo and set of tools for discovering, retrieving, inspecting, and visualizing archived weather-model data. Users can download complete datasets from NSC URLs, interactively select fields and download them through the notebook UI, or extract fields using Polytope/FDB; analysis notebooks demonstrate plots such as time-height views. Supporting tools maintain version metadata, scan FDB contents into selection catalogs, and provide an example archive workflow. The UI and several notebook implementations were only partially sampled or not sampled, so their documented capabilities are shown without inferring internal call chains.
Main entry points: pt_UI.py Interactive selector · versions.py Version catalog · fdb_scan_to_json.py FDB catalog scan · polytope_helper.ipynb Polytope selection
Components 19
Catalog and metadata
- Version catalog
versions.py - Version metadata
json/versions.json - Parameter metadata
json/para_codes.json - FDB catalog scan
fdb_scan_to_json.py - Archive selection catalogs
json
Data retrieval
- URL downloader
download.py - Interactive selector
pt_UI.py - Downloaded data file
- Polytope selection
polytope_helper.ipynb - FDB extraction example
polytope_fetch.ipynb
FDB archive tools
- Archive writer
fdb_example.py - FDB scanner
fdb_scan.py
Analysis examples
- Weather plots
paris_time_height_plot.ipynb - Subhour plots
paris_time_height_plot_subhour_200m.ipynb - Earthkit demonstrations
earthkit_example_paris.ipynb
Other components
- Data user
- NSC file hosting
- Polytope API
- ECMWF FDB
Connections 26
- Data user → Version catalog: lists versions
README.md - Version catalog → Version metadata: loads metadata
versions.py - URL downloader → Version catalog: resolves version
download.py - URL downloader → NSC file hosting: downloads files
download.py - Data user → URL downloader: requests download
README.md - Data user → Interactive selector: selects fields
README.md - Interactive selector → Version catalog: loads archive options
pt_UI.py - Interactive selector → Parameter metadata: loads parameter names
pt_UI.py - Interactive selector → Archive selection catalogs: loads archive catalog
pt_UI.py - Interactive selector → Downloaded data file: downloads selection
README.md - Data user → Polytope selection: explores archive
README.md - Polytope selection → Polytope API: requests data
- Polytope selection → ECMWF FDB: explores fields
README.md - Data user → FDB extraction example: runs extraction
README.md - FDB extraction example → ECMWF FDB: extracts fields
README.md - Data user → Archive writer: runs archive example
README.md - Archive writer → ECMWF FDB: archives data
fdb_example.py - Data user → FDB scanner: scans archive
README.md - FDB scanner → ECMWF FDB: lists archive keys
fdb_scan.py - Data user → FDB catalog scan: creates catalogs
README.md - FDB catalog scan → Version catalog: reads archive versions
fdb_scan_to_json.py - FDB catalog scan → ECMWF FDB: scans fields
fdb_scan_to_json.py - FDB catalog scan → Archive selection catalogs: writes catalogs
fdb_scan_to_json.py - Data user → Weather plots: runs visualization
README.md - Data user → Subhour plots: runs visualization
README.md - Data user → Earthkit demonstrations: runs demonstration
README.md