How einggraumfw/era5-site-explorer works
ERA5 Site Explorer is a local web app for requesting Copernicus ERA5 wave data and analysing wave-energy resources. The principal flow is site selection and request submission, CDS download, per-node analysis, then browser results and optional screening, device, long-term, cross-check and export tools. The README documents these capabilities; some plugin and frontend wiring is represented at the subsystem level because not all implementation excerpts were provided.
Main entry points: app.py Flask app and jobs · plugins.py Plugin runtime · app.js Explorer UI · fetch_era5_waves.py ERA5 fetcher
Components 21
Web interface
- Explorer UI
static/app.js - App page
templates/index.html - Flask app and jobs
app.py
Data acquisition
- ERA5 fetcher
fetch_era5_waves.py - Downloaded job data
Wave analysis
- Node analysis
analysis.py - Wave calculations
wavecalc.py - Route cross-check
crosscheck.py
Resource tools
- Screening routes
plugin_screening.py - Node screening
screening.py - Device routes
plugin_device.py - Device catalogue
devices_catalogue.py - Device assessment
device.py - Long-term routes
plugin_longterm.py - Long-term statistics
longterm.py - Export routes
plugin_export.py - Reports and tables
report.py
Shared runtime
- Plugin runtime
plugins.py - NetCDF and writes
netcdf_safety.py
Other components
- Site analyst
- Copernicus CDS
Connections 23
- Site analyst → Explorer UI: chooses site
README.md - App page → Explorer UI: hosts interface
- Explorer UI → Flask app and jobs: submits requests
- Flask app and jobs → ERA5 fetcher: starts download
app.py - ERA5 fetcher → Copernicus CDS: requests ERA5
README.md - ERA5 fetcher → Downloaded job data: writes downloads
- Flask app and jobs → Downloaded job data: reads job data
- Flask app and jobs → Node analysis: analyses job
app.py - Node analysis → Wave calculations: calculates wave metrics
analysis.py - Node analysis → NetCDF and writes: uses NetCDF lock
analysis.py - Flask app and jobs → Route cross-check: runs comparison
app.py - Flask app and jobs → Plugin runtime: loads feature routes
app.py - Plugin runtime → Screening routes: registers routes
plugins.py - Plugin runtime → Device routes: registers routes
plugins.py - Plugin runtime → Long-term routes: registers routes
plugins.py - Plugin runtime → Export routes: registers routes
plugins.py - Screening routes → Node screening: computes screening
plugin_screening.py - Device routes → Device catalogue: loads device choices
plugin_device.py - Device routes → Device assessment: assesses performance
plugin_device.py - Long-term routes → Long-term statistics: computes statistics
plugin_longterm.py - Export routes → Reports and tables: builds exports
plugin_export.py - Plugin runtime → NetCDF and writes: writes atomically
plugins.py - Flask app and jobs → Explorer UI: returns results