Welcome to WEkEO4Atmosphere

wekeo4atmosphere is a repository of Python based tools to introduce you to atmospheric data on the WEkEO DIAS (Data Information and Access System) and its JupyterHub. With the help of cases studies about the monitoring of wildfires and air quality, Copernicus atmosphere data from the Copernicus Programme are introduced. Practical examples showcase how to access, load, browse and visualise data.

The content provided is based on Jupyter Notebooks, which allow a high-level of interactive learning, as code, text description and visualisation is combined in one place.

Copernicus Data

The notebooks feature the following Copernicus datasets for atmospheric applications

• Satellite-based datasets:

  • Copernicus Sentinel-5P TROPOMI
  • Level 2 Carbon Monoxide product
  • Level 2 Nitrogen Dioxide product
  • Copernicus Sentinel-3 OLCI Level-1B Full Resolution

• Model-based datasets:

  • CAMS global reanalysis (EAC4)
  • CAMS European air quality forecasts

Repository overview

This repository is organised in two atmospheric case studies on (i) fire monitoring and (ii) air quality. For each case study a set of Copernicus data is introduced that is suitable for fire or air quality applications and available via WEkEO. Each dataset is introduced via two notebooks: the first notebooks show how to retrieve the respective dataset from WEkEO (retrieve notebooks) and the second notebook offers a practical example on how to load, browse and visualise the dataset (explore notebooks). The following notebook are available: * Case study fire monitoring (folder ./fire/): * 10 - Sentinel-5P Level 2 Carbon Monoxide - Retrieve * 11 - Sentinel-5P Level 2 Carbon Monoxide - Explore * 20 - Sentinel-3 OLCI Level 1B - Retrieve * 21 - Sentinel-3 OLCI Level 1B - Explore * 30 - CAMS global reanalysis EAC4 - Retrieve * 31 - CAMS global reanalysis EAC4 - Explore

• Case study air quality (folder ./air_quality/):
  • 10 - Sentinel-5P Level 2 Nitrogen Dioxide - Retrieve
  • 11 - Sentinel-5P Level 2 Nitrogen Dioxide - Explore
  • 20 - CAMS European air quality forecast - Nitrogen Dioxide - Retrieve
  • 21 - CAMS European air quality forecast - Nitrogen Dioxide - Explore

How to use this material

If you are on GitHub/Lab you can visit www.wekeo.eu, register for an account and enter the JupyterHub - then follow the instructions below.

If you are currently on the WEkEO JupyterLab you're already in the right place and can start. To clone this repository in to the WEkEO JupyterHub environment open a terminal in the WEkEO JupyterHub and type:

cd work
git clone https://github.com/wekeo/wekeo4atmosphere.git

This will create a clone of this repository in the work directory on your WEkEO JupyterHub instance. You can use the same command to clone any external repository you like. You can also use this code on your own computer/JupyterHub server, however you will not have the fast access provided by the Harmonized Data Access as part of the WEkEO infrastructure.

Recommended Python set up

The content in this repository has been tested with Python version 3.8.15. We highly recommend that users working on their own systems install the appropriate Anaconda distribution for their operating system. Here is a link to the Anaconda distribution of Python 3.8.

Python environment

Python allows users to create specific environments that suit their applications. This tutorial requires a number of specific Python packages and their respective versions. You can see the full list in the environment.yml file. WEkEO's JupyterHub environment has already all required packages installed. You might need to install them for your local installation.