README.md

metadata

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.