---
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.