| --- |
| title: Global Wind Map |
| emoji: 🌍 |
| colorFrom: blue |
| colorTo: green |
| sdk: gradio |
| sdk_version: 4.19.2 |
| app_file: app.py |
| pinned: false |
| license: mit |
| --- |
| |
| # 🌍 Global Wind Map |
|
|
| A real-time interactive wind map showing global wind patterns using live data from the OpenMeteo API. |
|
|
| ## 🌟 Features |
|
|
| - **🌬️ Real-Time Wind Data**: Live wind speed and direction from OpenMeteo API |
| - **🗺️ Interactive Map**: Pan, zoom, and explore wind patterns worldwide |
| - **📊 Multiple Visualizations**: |
| - Animated wind particles |
| - Color-coded wind vectors |
| - Wind speed heatmap |
| - **🎛️ Customizable Display**: |
| - Adjustable data resolution |
| - Toggle different visualization layers |
| - Detailed wind information on hover |
|
|
| ## 🚀 Usage |
|
|
| 1. Adjust the resolution slider to control data density |
| 2. Toggle visualization layers: |
| - Wind Vectors: Arrows showing wind direction and speed |
| - Wind Speed Heatmap: Color-coded wind intensity |
| - Animated Particles: Dynamic wind flow visualization |
| 3. Click on wind vectors for detailed information |
| 4. Pan and zoom to explore different regions |
|
|
| ## 🛠️ Technical Details |
|
|
| - Built with Gradio and Folium |
| - Real-time data from OpenMeteo API |
| - Parallel data fetching for improved performance |
| - Adaptive resolution based on latitude |
| - Enhanced visualization with dynamic scaling |
|
|
| ## 📝 Data Sources |
|
|
| Wind data is provided by the [OpenMeteo API](https://open-meteo.com/), offering: |
| - Current wind conditions |
| - Global coverage |
| - Regular updates |
| - Wind speed and direction at 10m height |
|
|
| ## 🤝 Contributing |
|
|
| Feel free to open issues or submit pull requests to improve the visualization! |
|
|
| ## Wind Pattern Simulation |
|
|
| The application currently displays simulated wind data with realistic patterns: |
|
|
| - **Trade Winds**: Easterly winds near the equator (-30° to 30° latitude) |
| - **Westerlies**: Westerly winds in mid-latitudes (30° to 60° and -60° to -30°) |
| - **Polar Winds**: Variable winds in polar regions |
|
|
| ## Quick Start |
|
|
| ### Option 1: Using the run script |
| ```bash |
| chmod +x run.sh |
| ./run.sh |
| ``` |
|
|
| ### Option 2: Manual setup |
| ```bash |
| # Create and activate virtual environment |
| python3 -m venv venv |
| source venv/bin/activate |
| |
| # Install dependencies |
| pip install -r requirements.txt |
| |
| # Run the application |
| python app.py |
| ``` |
|
|
| ## Usage |
|
|
| 1. **Start the application** using one of the methods above |
| 2. **Open your browser** to the provided URL (typically `http://localhost:7860`) |
| 3. **Adjust controls** in the left panel: |
| - **Data Resolution**: Lower values = more detail (but slower rendering) |
| - **Show Wind Vectors**: Toggle wind direction arrows |
| - **Show Wind Speed Heatmap**: Toggle colored wind speed overlay |
| 4. **Explore the map** by zooming and panning |
| 5. **Click on wind arrows** to see detailed wind information |
|
|
| ## Wind Speed Legend |
|
|
| - 🔵 **Blue (0-3 m/s)**: Light winds |
| - 🟢 **Green (3-7 m/s)**: Moderate winds |
| - 🟠 **Orange (7-12 m/s)**: Strong winds |
| - 🔴 **Red (12+ m/s)**: Very strong winds |
|
|
| ## Dependencies |
|
|
| - **gradio**: Web interface framework |
| - **folium**: Interactive mapping library |
| - **numpy**: Numerical computations |
| - **pandas**: Data manipulation |
| - **requests**: HTTP requests (for future API integration) |
|
|
| ## Future Enhancements |
|
|
| The current version uses simulated data for demonstration. Planned improvements include: |
|
|
| - **Real Weather Data**: Integration with APIs like: |
| - OpenWeather API |
| - NOAA Global Forecast System |
| - European Centre for Medium-Range Weather Forecasts |
| - **Historical Data**: View wind patterns from past dates |
| - **Weather Forecast**: Show predicted wind patterns |
| - **Additional Layers**: Temperature, pressure, precipitation |
| - **Export Features**: Save maps as images or data |
|
|
| ## Configuration |
|
|
| For production deployment on Hugging Face Spaces, the application will automatically start when the Space is loaded. |
|
|
| ## Development |
|
|
| To extend the application: |
|
|
| 1. **Add real data sources** in the `get_wind_data()` function |
| 2. **Customize map styling** in the `create_wind_map()` function |
| 3. **Add new controls** in the Gradio interface section |
| 4. **Implement additional weather layers** using Folium plugins |
|
|
| ## License |
|
|
| GPL-3.0 License - see the LICENSE file for details. |
|
|
