README.md

---
title: CAMS Air Pollution Dashboard
emoji: 🌍
colorFrom: green
colorTo: blue
sdk: docker
pinned: false
license: mit
app_port: 7860
---

# CAMS Air Pollution Dashboard

A comprehensive web application for visualizing atmospheric composition data from the Copernicus Atmosphere Monitoring Service (CAMS).

## Features

- 🌍 Interactive air pollution maps for India
- 📊 Multiple pollutant visualization (PM2.5, PM10, NO2, O3, CO, etc.)
- 🎨 Various color themes for data visualization
- 📁 Support for NetCDF file uploads
- 🌐 Direct CAMS data download integration
- 📈 Statistical analysis and hover information

## Usage

1. Upload your own NetCDF files or download CAMS data for specific dates
2. Select variables, pressure levels, and time points
3. Generate static or interactive pollution maps
4. Explore air quality data with detailed statistics

## Data Source

This application uses data from the Copernicus Atmosphere Monitoring Service (CAMS), which provides global atmospheric composition forecasts and analyses.

## CDS API Configuration

For downloading CAMS data, you need to set up CDS API credentials:

### For Hugging Face Spaces (Recommended):
1. Create an account at https://cds.climate.copernicus.eu/
2. Go to your user profile and copy your API credentials
3. In your Hugging Face Space settings, add these as **Secrets**:
   - `CDSAPI_URL`: `https://ads.atmosphere.copernicus.eu/api`
   - `CDSAPI_KEY`: Your API key from the CDS website

### For Local Development:
You can create a `.cdsapirc` file in your home directory:
```
url: https://ads.atmosphere.copernicus.eu/api
key: your-api-key-here
```

**Note**: Never commit `.cdsapirc` files to public repositories as they contain sensitive credentials.

You can also upload your own NetCDF files to explore the visualization features without API access.