This overview demonstrates the basic capabilities of eodag in a simple worflow, whose steps are introduced in more details in the following pages.
The workflow consists of the following steps:
Configure: eodag is configured to use the provider cop_dataspace (registering to cop_dataspace is required to download the products, see how to register to a provider)
Search: Sentinel 2 Level-1C products (i.e. images) are searched for over an area in France in March 2021.
Crunch: Two dedicated filters - that we call crunchers - provided by eodag are used to select products with a cloud cover less than 30% and covering the city of Toulouse (France).
Serialize: Save the filtered products as a GeoJSON file.
Now we will configure eodag to be able to download using cop_dataspace. For that we need to fill our credentials:
in the user configuration file ~/.config/eodag/eodag.yml:
cop_dataspace:priority:# Lower value means lower priority (Default: 1)search:# Search parameters configurationdownload:extract:# whether to extract the downloaded products (true or false, Default: true).output_dir:# where to store downloaded products.dl_url_params:# additional parameters to pass over to the download url as an url parameterdelete_archive:# whether to delete the downloaded archives (true or false, Default: true).auth:credentials:username:PLEASE_CHANGE_MEpassword:PLEASE_CHANGE_ME
or using environment variables: (we also set output_dir, the directory where to store downloaded products)
Logging is then activated with the setup_logging() method. It’s a useful way to see what eodag does under the hood, e.g. requesting the provider, adapting the response. It’s also useful to detect when things go wrong, and, if relevant, create an issue on GitHub with the log messages.
[6]:
fromeodagimportsetup_loggingsetup_logging(2)# 3 for even more information
The next object to import, and this is certainly one of the most important objects provided by eodag, is the EODataAccessGateway class. The creation of a single instance of this class is enough in a workflow, it is going to take care of configuring the providers, exposing the products configured off-the-shelf by eodag, and many more things.
2026-03-26 18:08:49,052 eodag.provider [INFO ] Loading user configuration from: /home/sbrunato/.config/eodag/eodag.yml
2026-03-26 18:08:49,076 eodag.core [INFO ] Locations configuration loaded from /home/sbrunato/.config/eodag/locations.yml
eodag stores an internal catalog of products it makes easily accessible. Sentinel 2 Level-1C products are designated with the identifier S2_MSI_L1C. It’s possible to check that it’s made available by cop_dataspace with the method list_collections() which returns a list of Collection instances, each one of them containing general
metadata (eodag’s collection id, platform, sensor type, etc.).
[8]:
dag.list_collections("cop_dataspace")
[8]:
CollectionsList (63)
0
Collection("S1_AUX_GNSSRD")
id:
'S1_AUX_GNSSRD',
title:
'SENTINEL1 Auxiliary Product',
description:
'The Auxiliary (AUX) product contains the precise orbit ephemerides and the GNSS-Raw Data (GNSSRD) data.
The precise orbit ephemerides are provided as a text file in the format of the International GNSS Service (IGS).
The GNSS-Raw Data (GNSSRD) data is provided as a binary file in a specific format.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The Auxiliary (AUX) product contains the precise orbit ephemerides and the GNSS-Raw Data (GNSSRD) data.
The precise orbit ephemerides are provided as a text file in the format of the European Space Operations Centre
(ESOC).
The GNSS-Raw Data (GNSSRD) data is provided as a binary file in a specific format.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The Auxiliary (AUX) product contains the precise orbit ephemerides and the GNSS-Raw Data (GNSSRD) data.
The precise orbit ephemerides are provided as a text file in the format of the European Space Operations Centre
(ESOC).
The GNSS-Raw Data (GNSSRD) data is provided as a binary file in a specific format.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The Auxiliary (AUX) product contains the precise orbit ephemerides and the GNSS-Raw Data (GNSSRD) data.
The precise orbit ephemerides are provided as a text file in the format of the European Space Operations Centre
(ESOC).
The GNSS-Raw Data (GNSSRD) data is provided as a binary file in a specific format.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The Auxiliary (AUX) product contains the precise orbit ephemerides and the GNSS-Raw Data (GNSSRD) data.
The precise orbit ephemerides are provided as a text file in the format of the European Space Operations Centre
(ESOC).
The GNSS-Raw Data (GNSSRD) data is provided as a binary file in a specific format.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The Auxiliary (AUX) product contains the precise orbit ephemerides and the GNSS-Raw Data (GNSSRD) data.
The precise orbit ephemerides are provided as a text file in the format of the European Space Operations Centre
(ESOC).
The GNSS-Raw Data (GNSSRD) data is provided as a binary file in a specific format.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'Level-1 Ground Range Detected (GRD) products consist of focused SAR data that has been detected, multi-looked and
projected to ground range using an Earth ellipsoid model. Phase information is lost. The resulting product has
approximately square spatial resolution pixels and square pixel spacing with reduced speckle at the cost of worse
spatial resolution.
GRD products can be in one of three resolutions: |
Full Resolution (FR),
High Resolution (HR),
Medium Resolution (MR).
The resolution is dependent upon the amount of multi-looking performed. Level-1 GRD products are available in MR
and HR for IW and EW modes, MR for WV mode and MR, HR and FR for SM mode.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'Level-1 Ground Range Detected (GRD) products consist of focused SAR data that has been detected, multi-looked and
projected to ground range using an Earth ellipsoid model. Phase information is lost. The resulting product has
approximately square spatial resolution pixels and square pixel spacing with reduced speckle at the cost of worse
spatial resolution.
GRD products can be in one of three resolutions: |
Full Resolution (FR),
High Resolution (HR),
Medium Resolution (MR).
The resolution is dependent upon the amount of multi-looking performed. Level-1 GRD products are available in MR
and HR for IW and EW modes, MR for WV mode and MR, HR and FR for SM mode.
Product containing Cloud Optimized GeoTIFF images, without SAFE formatting.
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'Level-3 DH (Dual polarization High Resolution) products are terrain corrected (geocoded) products in map geometry,
projected using the Range-Doppler model and resampled using nearest neighbor method. The pixel spacing is
approximately 10 m x 10 m. The product is available in dual polarization (HH+HV or VV+VH). The product is provided
in GeoTIFF format.
Product containing Cloud Optimized GeoTIFF images, without SAFE formatting.
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'Level-3 IW (Interferometric Wide Swath) products are terrain corrected (geocoded) products in map geometry,
projected using the Range-Doppler model and resampled using nearest neighbor method. The pixel spacing is
approximately 10 m x 10 m. The product is available in two polarizations: Single (HH or VV) and Dual (HH+HV or
VV+VH). The product is provided in GeoTIFF format.
Product containing Cloud Optimized GeoTIFF images, without SAFE formatting.
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'Level-2 OCN products include components for Ocean Swell spectra (OSW) providing continuity with ERS and ASAR WV
and two new components: Ocean Wind Fields (OWI) and Surface Radial Velocities (RVL).
The OSW is a two-dimensional ocean surface swell spectrum and includes an estimate of the wind speed and direction
per swell spectrum. The OSW is generated from Stripmap and Wave modes only. For Stripmap mode, there are multiple
spectra derived from internally generated Level-1 SLC images. For Wave mode, there is one spectrum per vignette.
The OWI is a ground range gridded estimate of the surface wind speed and direction at 10 m above the surface
derived from internally generated Level-1 GRD images of SM, IW or EW modes.
The RVL is a ground range gridded difference between the measured Level-2 Doppler grid and the Level-1 calculated
geometrical Doppler.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The SAR Level-0 products consist of the sequence of Flexible Dynamic Block Adaptive Quantization (FDBAQ) compressed
unfocused SAR raw data. For the data to be usable, it will need to be decompressed and processed using a SAR
processor.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'Level-1 Single Look Complex (SLC) products consist of focused SAR data geo-referenced using orbit and attitude
data from the satellite and provided in zero-Doppler slant-range geometry. The products include a single look in
each dimension using the full transmit signal bandwidth and consist of complex samples preserving the phase
information.
SAFE formatted product, see
https://sentinel.esa.int/web/sentinel/user-guides/sentinel-1-sar/data-formats/safe-specification
',
'The Level-1C product is composed of 100x100 km2 tiles (ortho-images in UTM/WGS84 projection). It results from
using a Digital Elevation Model (DEM) to project the image in cartographic geometry. Per-pixel radiometric
measurements are provided in Top Of Atmosphere (TOA) reflectances along with the parameters to transform them
into radiances. Level-1C products are resampled with a constant Ground Sampling Distance (GSD) of 10, 20 and 60
meters depending on the native resolution of the different spectral bands. In Level-1C products, pixel
coordinates refer to the upper left corner of the pixel. Level-1C products will additionally include Cloud Masks
and ECMWF data (total column of ozone, total column of water vapour and mean sea level pressure).
SAFE formatted product, see https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi/data-formats
',
'The Level-2A product provides Bottom Of Atmosphere (BOA) reflectance images derived from the associated Level-1C
products. Each Level-2A product is composed of 100x100 km2 tiles in cartographic geometry (UTM/WGS84 projection).
SAFE formatted product, see https://sentinel.esa.int/web/sentinel/user-guides/sentinel-2-msi/data-formats
',
'OLCI (Ocean and Land Colour Instrument) Full resolution: 300m at nadir. Level 1 products are calibrated
Top Of Atmosphere radiance values at OLCI 21 spectral bands. Radiances are computed from the instrument digital
counts by applying geo-referencing, radiometric processing (non-linearity correction, smear correction, dark offset
correction, absolute gain calibration adjusted for gain evolution with time), and stray-light correction for
straylight effects in OLCI camera's spectrometer and ground imager. Additionally, spatial resampling of OLCI pixels
to the 'ideal' instrument grid, initial pixel classification, and annotation at tie points with auxiliary
meteorological data and acquisition geometry are provided. The radiance products are accompanied by error estimate
products, however the error values are currently not available. - All Sentinel-3 NRT products are available at
pick-up point in less than 3h. - All Sentinel-3 Non Time Critical (NTC) products are available at pick-up point in
less than 30 days. Sentinel-3 is part of a series of Sentinel satellites, under the umbrella of the
EU Copernicus programme.
',
'OLCI (Ocean and Land Colour Instrument) Reduced resolution: 1200m at nadir. All Sentinel-3 NRT products are
available at pick-up point in less than 3h. Level 1 products are calibrated Top Of Atmosphere radiance values
at OLCI 21 spectral bands. Radiances are computed from the instrument digital counts by applying geo-referencing,
radiometric processing (non-linearity correction, smear correction, dark offset correction, absolute gain
calibration adjusted for gain evolution with time), and stray-light correction for straylight effects in OLCI
camera's spectrometer and ground imager. Additionally, spatial resampling of OLCI pixels to the 'ideal' instrument
grid, initial pixel classification, and annotation at tie points with auxiliary meteorological data and acquisition
geometry are provided. The radiance products are accompanied by error estimate products, however the error values
are currently not available. - All Sentinel-3 NRT products are available at pick-up point in less than 3h
- All Sentinel-3 Non Time Critical (NTC) products are available at pick-up point in less than 30 days Sentinel-3 is
part of a series of Sentinel satellites, under the umbrella of the EU Copernicus programme.
',
'Sentinel-3 STM payload includes two main instruments: the Sentinel-3 Radar ALtimeter (SRAL) and a MicroWave
Radiometer (MWR). SRAL is providing continuous topography measurements of the Earth's surface. It is the first
radar altimeter operating exclusively with delay-Doppler capabilities, which provides a significant improvement of
the along-track resolution compared to conventional Low Resolution Mode (LRM) altimeters. This enhancement is
highly valuable over continental and sea ice surfaces, considering their heterogeneous characteristics.
ESA and the Sentinel-3 Mission Performance Cluster (MPC) have developed in 2021-2022 dedicated delay-Doppler and
Level-2 processing chains for the generation of new Sentinel-3 STM LAND level-2 products over inland waters,
sea-ice, and land ice areas. The main objective of these so-called “Thematic Products” is to address the specific
needs of the user communities related to the three different Thematic surfaces.
For Hydrology Thematic Products, the coverage includes all the continental surfaces, except the Antarctica ice
sheet, and Greenland ice sheet interior. Over coastal zones the 50 km common area between Land and Marine products
remains. Therefore, the Hydrology products cover up to 25 km over surfaces considered as Marine.
',
'Sentinel-3 STM payload includes two main instruments: the Sentinel-3 Radar ALtimeter (SRAL) and a MicroWave
Radiometer (MWR). SRAL is providing continuous topography measurements of the Earth's surface. It is the first
radar altimeter operating exclusively with delay-Doppler capabilities, which provides a significant improvement of
the along-track resolution compared to conventional Low Resolution Mode (LRM) altimeters. This enhancement is
highly valuable over continental and sea ice surfaces, considering their heterogeneous characteristics.
ESA and the Sentinel-3 Mission Performance Cluster (MPC) have developed in 2021-2022 dedicated delay-Doppler and
Level-2 processing chains for the generation of new Sentinel-3 STM LAND level-2 products over inland waters,
sea-ice, and land ice areas. The main objective of these so-called “Thematic Products” is to address the specific
needs of the user communities related to the three different Thematic surfaces.
Each Sentinel-3 STM Land Thematic Product has a dedicated geographical coverage, defined in a Thematic Mask. For
Land Ice Thematic Products, the mask includes the Antarctica and Greenland ice sheets, along with glacier areas as
defined in the Randolph Glacier Inventory (RGI) database.
',
'Sentinel-3 STM payload includes two main instruments: the Sentinel-3 Radar ALtimeter (SRAL) and a MicroWave
Radiometer (MWR). SRAL is providing continuous topography measurements of the Earth's surface. It is the first
radar altimeter operating exclusively with delay-Doppler capabilities, which provides a significant improvement of
the along-track resolution compared to conventional Low Resolution Mode (LRM) altimeters. This enhancement is
highly valuable over continental and sea ice surfaces, considering their heterogeneous characteristics.
ESA and the Sentinel-3 Mission Performance Cluster (MPC) have developed in 2021-2022 dedicated delay-Doppler and
Level-2 processing chains for the generation of new Sentinel-3 STM LAND level-2 products over inland waters,
sea-ice, and land ice areas. The main objective of these so-called “Thematic Products” is to address the specific
needs of the user communities related to the three different Thematic surfaces.
Each Sentinel-3 STM Land Thematic Product has a dedicated geographical coverage, defined in a Thematic Mask. For Sea
Ice Thematic Products, the mask remains static, and the coverage was calculated by the Expert Support
Laboratories (ESL) of the Sentinel-3 MPC, based on the maximum of sea ice extent given a NSIDC sea ice climatology.
',
'The OLCI Level-2 Land Full Resolution (OL_2_LFR) products contain land and atmospheric geophysical products at Full
resolution with a spatial sampling of approximately 300 m. The products are assumed to be computed in Near Real
Time (NRT) (i.e. delivered to users less than 3 hours after acquisition), in Non-Time Critical (NTC) (i.e.
within 1 month after acquisition) or in re-processed NTC.
Details at https://sentinel.esa.int/web/sentinel/user-guides/sentinel-3-olci/product-types/level-2-land
',
'The OLCI Level-2 Land Reduced Resolution (OL_2_LRR) products contain land and atmospheric geophysical products
at Reduced resolution with a spatial sampling of approximately 1.2 km. The products are assumed to be computed
in Near Real Time (NRT) (i.e. delivered to users less than 3 hours after acquisition), in Non-Time Critical
(NTC) (i.e. within 1 month after acquisition) or in re-processed NTC.
Details at https://sentinel.esa.int/web/sentinel/user-guides/sentinel-3-olci/product-types/level-2-land
',
'The OLCI Level-2 Water Full Resolution (OL_2_WFR) products contain water and atmospheric geophysical products at Full
resolution with a spatial sampling of approximately 300 m. The products are assumed to be computed in Near Real
Time (NRT) (i.e. delivered to users less than 3 hours after acquisition), in Non-Time Critical (NTC) (i.e.
within 1 month after acquisition) or in re-processed NTC.
Details at https://sentinel.esa.int/web/sentinel/user-guides/sentinel-3-olci/product-types/level-2-water
',
'SENTINEL3 OLCI Level-2 Water Reduced Resolution',
description:
'The OLCI Level-2 Water Reduced Resolution (OL_2_WRR) products contain water and atmospheric geophysical products
at Reduced resolution with a spatial sampling of approximately 1.2 km. The products are assumed to be computed
in Near Real Time (NRT) (i.e. delivered to users less than 3 hours after acquisition), in Non-Time Critical
(NTC) (i.e. within 1 month after acquisition) or in re-processed NTC.
Details at https://sentinel.esa.int/web/sentinel/user-guides/sentinel-3-olci/product-types/level-2-water
',
'SLSTR Level-1 observation mode products consisting of full resolution,
geolocated, co-located nadir and along track view, Top of Atmosphere
(TOA) brightness temperatures (in the case of thermal IR channels) or
radiances (in the case of visible, NIR and SWIR channels) from all
SLSTR channels, and quality flags, pixel classification information
and meteorological annotations
',
'The Copernicus NRT S3 AOD processor quantifies the abundance of aerosol particles and monitors their global
distribution and long-range transport, at the scale of 9.5 x 9.5 km2. All observations are made available in
less than three hours from the SLSTR observation sensing time. It is only applicable during daytime.
NOTE: The SLSTR L2 AOD product is generated by EUMETSAT in NRT only. An offline (NTC) AOD product is generated
from SYN data by ESA, exploiting the synergy between the SLSTR and OLCI instruments.
',
'The SLSTR Level-2 FRP product is providing one measurement data file, FRP_in.nc, with Fire Radiative Power (FRP)
values and associated parameters generated for each fire detected over land and projected on the SLSTR 1 km grid.
The fire detection is based on a mixed thermal band, combining S7 radiometric measurements and,
for pixels associated with a saturated value of S7 (i.e. above 311 K), F1 radiometric measurements.
',
'The SLSTR Level-2 LST product provides land surface parameters generated on the wide 1 km measurement grid.
It contains measurement file with Land Surface Temperature (LST) values with associated parameters (LST
parameters are computed and provided for each pixel (re-gridded or orphan) included in the 1 km measurement grid)
',
'The SLSTR Level-2 WST product provides water surface parameters generated on the wide 1 km measurement grid.
It contains measurement file with Water Surface Temperature (WST) values with associated parameters (WST
parameters are computed and provided for each pixel (re-gridded or orphan) included in the 1 km measurement grid)
',
'SRAL Level 1B: Complex echoes (In-phase (I) and Quadrature (Q)) for the Low Resolution Mode (LRM) and/or
Synthetic Aperture Radar (SAR) mode both for C Band and Ku band. When the altimeter is in SAR mode, this product
also contains the so-called Pseudo LRM (PLRM) echoes. - All Sentinel-3 Near Real Time (NRT) products are available
at pick-up point in less than 3h. - All Sentinel-3 Non Time Critical (NTC) products are available at pick-up point
in less than 30 days. - All Sentinel-3 Short Time Critical (STC) products are available at pick-up point in less
than 48 hours. Sentinel-3 is part of a series of Sentinel satellites, under the umbrella of the EU Copernicus programme.
',
'A Level 1A SRAL product contains one "measurement data file" containing the L1A measurements parameters:
ECHO_SAR_Ku: L1A Tracking measurements (sorted and calibrated) in SAR mode - Ku-band (80-Hz)
ECHO_PLRM: L1A Tracking measurements (sorted and calibrated) in pseudo-LRM mode - Ku and C bands (80-Hz)
',
'A Level 1B-S SRAL product contains one "measurement data file" containing the L1b measurements parameters:
ECHO_SAR_Ku : L1b Tracking measurements in SAR mode - Ku band (20-Hz) as defined in the L1b MEAS product
completed with SAR expert information
ECHO_PLRM : L1b Tracking measurements in pseudo-LRM mode - Ku and C bands (20-Hz) as defined in the L1b
MEAS product
',
'The Level-2 SYN AOD product (SY_2_AOD) is produced by a dedicated processor including the whole
SYN L1 processing module and a global synergy level 2 processing module retrieving, over land and
sea, aerosol optical thickness. The resolution of this product is wider than classic S3 products,
as the dataset are provided on a 4.5 km² resolution
',
'The Level-2 SYN product (SY_2_SYN) is produced by the Synergy Level-1/2 SDR software and contains
surface reflectance and aerosol parameters over land. All measurement datasets are provided on the
OLCI image grid, similar to the one included in the OLCI L1b product.
Some sub-sampled annotations and atmospheric datasets are provided on the OLCI tie-points grid.
Several associated variables are also provided in annotation data files.
',
'The Level-2 VG1 and V10 SYN products (SY_2_VG1 and SY_2_V10 respectively) are produced by the
SYNERGY Level-2 processor and contain 1 km VEGETATION-like product, 1 and 10 days synthesis surface
reflectances and NDVI. The product grid and the four spectral bands are similar to the SYN Level-2
VGP product.
',
'The Level-2 VG1 and V10 SYN products (SY_2_VG1 and SY_2_V10 respectively) are produced by the
SYNERGY Level-2 processor and contain 1 km VEGETATION-like product, 1 and 10 days synthesis surface
reflectances and NDVI. The product grid and the four spectral bands are similar to the SYN Level-2
VGP product.
',
'The Level-2 VGP SYN product (SY_2_VGP) is produced by the Global Synergy Level-1/2 software and
contains 1 km VEGETATION-like product TOA reflectances. The "1 km VEGETATION-like product" label
means that measurements are provided on a regular latitude-longitude grid, with an equatorial
sampling distance of approximately 1 km. This product is restricted in longitude, including only filled ones.
',
'The products contain the typical altimetry measurements, like the altimeter range, the sea surface height, the wind
speed, significant wave height and all required geophysical corrections and related flags. Also the sea Ice
freeboard measurement is included. The measurements in the standard data file provide the measurements in low
(1 Hz = approx. 7km) and high resolution (20 Hz = approx. 300 m), in LRM mode or in SAR mode, for both C-band and
Ku band. The SAR mode is the default mode. The reduced measurement data file contains 1 Hz measurements only. The
enhanced measurement data file contains also the waveforms and associated parameters and the pseudo LRM measurements
when in SAR mode. This product contains the following datasets: Sea Level Global(NRT) (PDS_MG3_CORE_14_GLONRT),
Sea Level Global Reduced(NRT)(PDS_MG3_CORE_14_GLONRT_RD), Sea Level Global Standard(NRT) (PDS_MG3_CORE_14_GLONRT_SD),
Sea Level Global Enhanced(NRT) (PDS_MG3_CORE_14_GLONRT_EN) - All Sentinel-3 NRT products are available at pick-up
point in less than 3h. - All Sentinel-3 Non Time Critical (NTC) products are available at pick-up point in less
than 30 days - All Sentinel-3 Short Time Critical (STC) products are available at pick-up point in less than 48
hours Sentinel-3 is part of a series of Sentinel satellites, under the umbrella of the EU Copernicus programme.
',
'Sentinel-5 Precursor Level 1B Irradiances for the SWIR bands',
description:
'Solar irradiance spectra for the SWIR bands (band 7 and band 8).
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Irradiances for the UVN bands',
description:
'Solar irradiance spectra for the UVN bands (band 1 through band 6).
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 1',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 1.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 2',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 2.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 3',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 3.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 4',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 4.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 5',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 5.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 6',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 6.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 7',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 7.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'Sentinel-5 Precursor Level 1B Radiances for spectral band 8',
description:
'Sentinel-5 Precursor Level 1B Radiances for spectral band 8.
TROPOMI utilises a single telescope to form an image of the target area onto a rectangular slit that acts as the
entrance slit of the spectrometer system. There are four different spectrometers, each with its own optics and
detector: mediumwave ultraviolet (UV), longwave ultraviolet combined with visible (UVIS), near infrared (NIR), and
shortwave infrared (SWIR). The spectrometers for UV, UVIS and NIR are jointly referred to as UVN. Radiation for the
SWIR spectrometer is transferred by an optical relay part in the UVN system from the telescope to an interface
position (the pupil stop) for the SWIR spectrometer. This is done because of the more stringent thermal requirements
on the SWIR part of the instrument.
Each of the detectors is divided in two halves, which yields a total of eight spectral bands.
',
'TROPOMI aerosol index is referred to as the Ultraviolet Aerosol Index (UVAI). The relatively simple calculation of
the Aerosol Index is based on wavelength dependent changes in Rayleigh scattering in the UV spectral range where
ozone absorption is very small. UVAI can also be calculated in the presence of clouds so that daily, global coverage
is possible. This is ideal for tracking the evolution of episodic aerosol plumes from dust outbreaks, volcanic ash,
and biomass burning.
',
'The TROPOMI Aerosol Layer Height product focuses on retrieval of vertically localised aerosol layers in the free
troposphere, such as desert dust, biomass burning aerosol, or volcanic ash plumes. The height of such layers is
retrieved for cloud-free conditions. Height information for aerosols in the free troposphere is particularly
important for aviation safety. Scientific applications include radiative forcing studies, long-range transport
modelling and studies of cloud formation processes. Aerosol height information also helps to interpret the UV
Aerosol Index (UVAI) in terms of aerosol absorption as the index is strongly height-dependent.
',
'Methane (CH4) is, after carbon dioxide (CO2), the most important contributor to the anthropogenically enhanced
greenhouse effect. Roughly three-quarters of methane emissions are anthropogenic and as such it is important to
continue the record of satellite-based measurements. TROPOMI aims at providing CH4 column concentrations with high
sensitivity to the Earth's surface, good spatio/temporal coverage, and sufficient accuracy to facilitate inverse
modelling of sources and sinks.
The output product consists of the retrieved methane column and a row vector referred to as the column averaging
kernel A. The column averaging kernel describes how the retrieved column relates to the true profile and should be
used in validation exercises (when possible) or use of the product in source/sink inverse modelling. The output
product also contains altitude levels of the layer interfaces to which the column averaging kernel corresponds.
Additional output for Level-2 data products: viewing geometry, precision of retrieved methane, residuals of the fit,
quality flags (cloudiness, terrain roughness etc.) and retrieved albedo and aerosol properties. The latter
properties are required for a posteriori filtering and for estimation of total retrieval error.
The Sentinel-5 Precursor mission flies in loose formation (about 3.5 - 5 minutes behind) with the S-NPP
(SUOMI-National Polar-orbiting Partnership) mission to use VIIRS (Visible Infrared Imaging Radiometer Suite) cloud
information to select cloud free TROPOMI pixels for high quality methane retrieval.
',
'The TROPOMI instrument, single payload onboard Sentinel-5 Precursor, retrieves operationally the most important
quantities for cloud correction of satellite trace gas retrievals: cloud fraction, cloud optical thickness (albedo),
and cloud-top pressure (height). Cloud parameters from TROPOMI are not only used for enhancing the accuracy of trace
gas retrievals, but also to extend the satellite data record of cloud information derived from oxygen A-band
measurements initiated with GOME.
',
'The TROPOMI instrument, single payload onboard Sentinel-5 Precursor, retrieves the CO global abundance exploiting
clear-sky and cloudy-sky Earth radiance measurements in the 2.3 µm spectral range of the shortwave infrared (SWIR)
part of the solar spectrum. TROPOMI clear sky observations provide CO total columns with sensitivity to the
tropospheric boundary layer. For cloudy atmospheres, the column sensitivity changes according to the light path.
The TROPOMI CO retrieval uses the same method employed by SCIAMACHY.
',
'Formaldehyde is an intermediate gas in almost all oxidation chains of Non-Methane Volatile Organic Compounds
(NMVOC), leading eventually to CO2. NMVOCs are, together with NOx, CO and CH4, among the most important precursors
of tropospheric O3. The major HCHO source in the remote atmosphere is CH4 oxidation. Over the continents, the
oxidation of higher NMVOCs emitted from vegetation, fires, traffic and industrial sources results in important and
localised enhancements of the HCHO levels.
In addition to the main product results, such as HCHO slant column, vertical column and air mass factor, the level 2
data files contain several additional parameters and diagnostic information.
',
'The TROPOMI instrument, single payload onboard Sentinel-5 Precursor, retrieves operationally tropospheric and
stratospheric NO2 column products. The TROPOMI NO2 data products pose an improvement over previous NO2 data sets,
particularly in their unprecedented spatial resolution, but also in the separation of the stratospheric and
tropospheric contributions of the retrieved slant columns, and in the calculation of the air-mass factors used to
convert slant to total columns.
',
'Sentinel-5 Precursor Level 2 NPP Cloud for band 3',
description:
'S5P-NPP Cloud for spectral band 3.
The S5P level 2 methane product is dependent on having information on cloud occurrence at spatial resolution finer
than that achievable from TROPOMI itself. This information is also useful for other purposes, including assessing
the influence of cloud on other L2 products and issues related to spatial co-registration. A level 2 auxiliary
product was therefore developed to describe cloud in the TROPOMI field of view (FOV), using co-located observations
of VIIRS (Visible Infra-red Imaging Radiometer Suite) on the U.S. S-NPP (Suomi - National Polar-orbiting
Partnership). S5P flies in a so-called loose formation with the S-NPP with a temporal separation between them of
less than 5 minutes.
The main information contained in the S5P-NPP product is:
1. A statistical summary for each S5P FOV of the NPP-VIIRS L2 Cloud Mask (VCM).
2. The mean and standard deviation of the sun-normalised radiance in a number of VIIRS moderate resolution bands.
This information is provided for three S5P spectral bands (to account for differences in spatial sampling).
',
'Sentinel-5 Precursor Level 2 NPP Cloud for band 6',
description:
'S5P-NPP Cloud for spectral band 6.
The S5P level 2 methane product is dependent on having information on cloud occurrence at spatial resolution finer
than that achievable from TROPOMI itself. This information is also useful for other purposes, including assessing
the influence of cloud on other L2 products and issues related to spatial co-registration. A level 2 auxiliary
product was therefore developed to describe cloud in the TROPOMI field of view (FOV), using co-located observations
of VIIRS (Visible Infra-red Imaging Radiometer Suite) on the U.S. S-NPP (Suomi - National Polar-orbiting
Partnership). S5P flies in a so-called loose formation with the S-NPP with a temporal separation between them of
less than 5 minutes.
The main information contained in the S5P-NPP product is:
1. A statistical summary for each S5P FOV of the NPP-VIIRS L2 Cloud Mask (VCM).
2. The mean and standard deviation of the sun-normalised radiance in a number of VIIRS moderate resolution bands.
This information is provided for three S5P spectral bands (to account for differences in spatial sampling).
',
'Sentinel-5 Precursor Level 2 NPP Cloud for band 7',
description:
'S5P-NPP Cloud for spectral band 7.
The S5P level 2 methane product is dependent on having information on cloud occurrence at spatial resolution finer
than that achievable from TROPOMI itself. This information is also useful for other purposes, including assessing
the influence of cloud on other L2 products and issues related to spatial co-registration. A level 2 auxiliary
product was therefore developed to describe cloud in the TROPOMI field of view (FOV), using co-located observations
of VIIRS (Visible Infra-red Imaging Radiometer Suite) on the U.S. S-NPP (Suomi - National Polar-orbiting
Partnership). S5P flies in a so-called loose formation with the S-NPP with a temporal separation between them of
less than 5 minutes.
The main information contained in the S5P-NPP product is:
1. A statistical summary for each S5P FOV of the NPP-VIIRS L2 Cloud Mask (VCM).
2. The mean and standard deviation of the sun-normalised radiance in a number of VIIRS moderate resolution bands.
This information is provided for three S5P spectral bands (to account for differences in spatial sampling).
',
'Ozone (O3) is of crucial importance for the equilibrium of the Earth's atmosphere. In the stratosphere, the ozone
layer shields the biosphere from dangerous solar ultraviolet radiation. In the troposphere, it acts as an efficient
cleansing agent, but at high concentration it also becomes harmful to the health of humans, animals, and vegetation.
Ozone is also an important greenhouse-gas contributor to ongoing climate change.
These products are provided in NetCDF-CF format and contain total ozone, ozone temperature, and error information
including averaging kernels.
',
'Retrieved ozone profiles are used to monitor the evolution of stratospheric and tropospheric ozone. Such monitoring
is important as the ozone layer protects life on Earth against harmful UV radiation. The ozone layer is recovering
from depletion due to manmade Chlorofluorocarbons (CFCs). Tropospheric ozone is toxic and it plays an important role
in tropospheric chemistry. Also, ozone is a greenhouse gas and is therefore also relevant for climate change.
The main parameters in the file are the retrieved ozone profile at 33 levels and the retrieved sub-columns of ozone
in 6 layers. In addition, the total ozone column and tropospheric ozone columns are provided. For the ozone profile,
the precision and smoothing errors, the a-priori profile and the averaging kernel are also provided.
',
'Ozone in the tropical troposphere plays various important roles. The intense UV radiation and high humidity in the
tropics stimulate the formation of the hydroxyl radical (OH) by the photolysis of ozone. OH is the most important
oxidant in the troposphere because it reacts with virtually all trace gases, such as CO, CH4 and other hydrocarbons.
The tropics are also characterized by large emissions of nitrogen oxides (NOx), carbon monoxide (CO) and
hydrocarbons, both from natural and anthropogenic sources. Ozone that is formed over regions where large amounts of
these ozone precursors are emitted, can be transported over great distances and affects areas far from the source.
The TROPOMI tropospheric ozone product is a level-2c product that represents three day averaged tropospheric ozone
columns on a 0.5° by 1° latitude-longitude grid for the tropical region between 20°N and 20°S. The TROPOMI
tropospheric ozone column product uses the TROPOMI Level-2 total OZONE and CLOUD products as input.
',
'Sulphur dioxide (SO2) enters the Earth's atmosphere through both natural (~30%) and anthropogenic processes (~70%).
It plays a role in chemistry on a local and global scale and its impact ranges from short term pollution to effects
on climate.
Beside the total column of SO2, enhanced levels of SO2 are flagged within the products. The recognition of enhanced
SO2 values is essential in order to detect and monitor volcanic eruptions and anthropogenic pollution sources.
Volcanic SO2 emissions may also pose a threat to aviation, along with volcanic ash.
',
The method set_preferred_provider() allows to declare cop_dataspace as the preferred provider, which means that eodag will look for products with this provider first (all the providers are pre-configured).
The EODataAccessGateway class provides three search methods which have a similar signature but behave in different ways:
search() returns a SearchResult that stores the products obtained from the first page with a given maximum number of items per page (default: limit=20). The attribute SearchResult.number_matched optionally stores the estimated total number of products matching
the search criteria.
Note
search() returns a paginated result. Pagination is the act of serving the result of a search page by page, each page contaning a maximum number of items. This is ubiquitous among search engines, e.g. a Google search displays in the browser 10 results per page. Pagination is built deep into the implementation of eodag since most providers return a paginated result.
Note
A search made with the search() method with its default parameter often ends up with a SearchResult containing 20 products and a significantly greater estimated total number of products available. The parameter limit can be set to a higher value, or, the search_all()
method can be used instead.
Warning
The SearchResult.number_matched property is the estimated total number of products matching the search criteria, since, unfortunately, all the providers do not return the exact total number.
search_all() returns a SearchResult that contains all the products matching the search criteria. It takes the pain away from thinking about pagination.
To get the S2_MSI_L1C products looked for, search() is used first as it’s handy to obtain some products and inspect them. Then search_all() is used to make all the products offered by cop_dataspace are collected.
The estimated total number of products matching the search criteria is stored in the number_matched attribute (set to None if count is disabled or not available).
[13]:
print(f"Got {len(products_first_page)} products and an estimated total number of {products_first_page.number_matched} products.")
Got 20 products and an estimated total number of 52 products.
A SearchResult contains a number of EOProduct. Each one of them has a properties attribute that is a dictionary storing the product’s metadata.
A product also has a location attribute. After being searched, it is equal to the remote location of the product, that will be used later by eodag to download it.
Crunching as defined in eodag is a way to filter the products contained in a SearchResult object. Several crunchers/filters are available (e.g. FilterProperty to filter products products according to one of their properties). They can be called by passing the cruncher
object to SearchResult.crunch() or by running a dedicated method (e.g. SearchResult.filter_property()). The following example shows how to filter products to keep only those whose cloud cover is less than 30%.
Before downloading any product, it can be useful to have a quick look at them. EO products usually offer a quicklook image, a low resolution by-product of the original data. An EOProduct has a get_quicklook method that takes care of downloading the quicklook image and returns its path. matplotlib can be used here to display the images collected.
[24]:
importmatplotlib.pyplotaspltimportmatplotlib.imageasmpimgquicklooks_dir=os.path.join(workspace,"quicklooks")ifnotos.path.isdir(quicklooks_dir):os.mkdir(quicklooks_dir)fig=plt.figure(figsize=(10,8))fori,productinenumerate(filtered_products,start=1):# This line takes care of downloading the quicklookquicklook_path=product.get_quicklook(output_dir=quicklooks_dir)img=mpimg.imread(quicklook_path)ax=fig.add_subplot(1,3,i)ax.set_title(i)plt.imshow(img)plt.tight_layout()
2026-03-26 18:11:44,037 eodag.product [INFO ] Download recorded in /home/sbrunato/workspace/eodag/docs/getting_started_guide/eodag_workspace_overview/quicklooks/S2B_MSIL1C_20210609T104619_N0500_R051_T31TCJ_20230314T070018
EOProducts can either be downloaded individually with download() or together with download_all() from a SearchResult. The last image is going to be downloaded, it is cloud-free and has no
no-data pixel.
Now the product is downloaded, it can be post-processed with softwares such as Sen2Cor or SNAP.
At some point eodag had some capabilities to directly post-process a product, i.e. to access its data. These capabilities, which relied on rasterio, have been ported to the Python package eodag-cube to avoid the heavy dependencies associated with GDAL in particular. Installing this package is enough to benefit from its capabilities, it is going to extend
EOProduct with a to_xarray() method which returns a product’s data as a XarrayDict, dictionnary of xarray.Dataset.
The capabilities of eodag-cube are used hereafter to compute the NDVI of the downloaded product over a sub-extent of the original product (this is actually Toulouse, France).
Warning
eodag-cube needs to be installed to run correcly the following code.
2026-03-26 18:15:14,429 eodag.download.base [INFO ] Product already present on this platform. Identifier: /home/sbrunato/workspace/eodag/docs/getting_started_guide/eodag_workspace_overview/S2B_MSIL1C_20210609T104619_N0500_R051_T31TCJ_20230314T070018
2026-03-26 18:15:14,429 eodag.product [INFO ] Remote location of the product is still available through its 'remote_location' property: https://catalogue.dataspace.copernicus.eu/odata/v1/Products(e50e9035-fd7c-403a-bebd-769a3a499954)/$value
.
