Skip to content

Data Gathering

The pydiva.gathering module provides pluggable gatherers that download data from remote archives and convert it into GEOMS files ready for GRASP processing.

Available Gatherers

Class Source
AeronetGatherer AERONET v3 REST API
ActrisAresGatherer ACTRIS ARES data portal
ActrisCloudnetGatherer ACTRIS CloudNet API
EarthCAREGatherer ESA EarthCARE L1/L2 products

Basic usage

from pydiva.gathering import AeronetGatherer
from datetime import date

gatherer = AeronetGatherer(site="Granada")
gatherer.fetch(start=date(2024, 1, 1), end=date(2024, 1, 31))

Common options

All gatherers inherit from BaseGatherer and share these parameters:

  • site — DIVA site name (see DivaSite enum)
  • output_path — destination directory for downloaded GEOMS files
  • overwrite — whether to re-download existing files (default: False)