| --- |
| title: NWPS SWAN Wave Data Puller |
| emoji: 🌊 |
| colorFrom: blue |
| colorTo: green |
| sdk: docker |
| pinned: false |
| license: gpl-3.0 |
| app_port: 7860 |
| tags: |
| - oceanography |
| - wave-data |
| - grib |
| - arctic |
| - meteorology |
| --- |
| |
| # 🌊 NWPS SWAN Wave Data Puller |
|
|
| A comprehensive wave data extraction and visualization tool that fetches real-time wave data from global meteorological sources including ECMWF and NOAA. |
|
|
| ## Features |
|
|
| - **Global GRIB Data**: Worldwide wave heights from ECMWF/NOAA GRIB files |
| - **Arctic Support**: Advanced Arctic wave data extraction with multiple fallback methods |
| - **Interactive Maps**: Real-time wave height visualization with Folium maps |
| - **Single Location Data**: NWPS SWAN model data for specific locations |
| - **Data Export**: JSON export functionality for analysis |
|
|
| ## Arctic Data Extraction |
|
|
| This application includes advanced Arctic wave data extraction capabilities that handle the common ECCODES polar stereographic projection errors. The system automatically: |
|
|
| - Attempts multiple extraction methods (pygrib, wgrib2, CDO) |
| - Provides fallback methods for problematic Arctic GRIB files |
| - Returns data in standardized format regardless of extraction method |
|
|
| ## Usage |
|
|
| 1. **Global GRIB Data**: Click "Fetch Global Wave Data" to download worldwide wave information |
| 2. **Single Location**: Use "Fetch Location Wave Data" for specific coordinates |
| 3. **Data Files**: View and analyze previously downloaded data files |
|
|
| ## Technical Details |
|
|
| - Built with Gradio for interactive web interface |
| - Uses pygrib, cfgrib, and xarray for GRIB file processing |
| - Folium maps for visualization |
| - Docker containerized for consistent deployment |
|
|
| ## Error Handling |
|
|
| The application gracefully handles: |
| - ECCODES polar stereographic errors in Arctic regions |
| - Temporary server unavailability |
| - Invalid GRIB files |
| - Network connectivity issues |
|
|
| --- |
|
|
| *Only real government/institutional wave data is supported - no synthetic data.* |
|
|
