meteocatalog

meteocatalog is a Docker container with functionalities to download different (mostly meteorological) datasets from sources like the German Weather Service (DWD) or Copernicus.
The downloaded data is mostly unchanged and organized in a well-structured way.

meteocatalog is built based on the tool-specs, a specification that allows standardization of inputs for dockerized tools. Parameters for running meteocatalog are defined in in/input.json and described in src/tool.yml.

Please be not intimidated by the use of Docker or the tool-specs, the execution of the tool is simple and is described here, you only need a working Docker installation on your computer.

Datasets

meteocatalog supports downloading a variety and growing amount of meteorological and environmental datasets, currently available datasets are listed in the table below.

| Dataset | Provider | Variables | Start year | End year | Temporal
resolution | Spatial
resolution | Coverage | CRS | TOOL_RUN | URL | |-------------------|------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------|--------------|----------------------------|---------------------------|--------------|------------------------------------------|--------------|--------------------------------------------------------------------------------------------------------------| | HYRAS | German Weather Service (DWD) | - Precipitation
- Radiation
- Humidity
- Mean temperature
- Max temperature
- Min temperature | 1931 (Precip.)
1951 | 2020 | 1 day | 1 km² (Precip.)
5 km² | Germany | ETRS89-extended / LCC Europe (EPSG:3034) | hyras | link | | RADKLIM-RW | German Weather Service (DWD) | - Precipitation | 2001 | 2023 | 1 hour | 1 km² | Germany | RADOLAN-grid | radklim_rw | link | | Hostrada | German Weather Service (DWD) | - Cloud cover
- Wind speed and direction (at 10m height)
- Near-surface air and dew point temperature (at 2m height)
- Relative humidity (at 2m height)
- Water vapor mixing ratio (at 2m height)
- Air pressure at station height and sea level
- Global shortwave radiation
- Urban heat island intensity | 1995 | 2024 | 1 hour | 1 km² | Germany | ETRS89-extended / LCC Europe (EPSG:3034) | hostrada | link | | E-Obs | Copernicus | - Mean temperature
- Minimum temperature
- Maximum temperature
- Precipitation
- Sea level pressure
- Relative humidity
- Wind speed
- Global radiation | 1950 | 2024 | 1 day | 0.1° x 0.1° | Europe | WGS84 (EPSG:4326) | | link | | DWD soil moisture | German Weather Service (DWD) | - soil moisture | 1991 | 2024 | 1 day | 1 km² | Germany | Gauss Krüger 3. meridian strip. | | link |

How to build the image?

You can build the image from within the root of this repo by docker build -t meteocatalog .

How to run?

Set the parameters for the datasets you want to download via the file in/input.json according to the specification in src/tool.yml. This template installs the json2args python package to parse the parameters in the /in/parameters.json.

To invoke the docker container directly run something similar to: docker run --rm -it -v ./in:/in -v /path/to/local/out:/out -e TOOL_RUN=init_meteocatalog meteocatalog Replace /path/to/local/out with the destination where you want to store the downloaded data and set the environment variable TOOL_RUN depending on which dataset you want to download, init_meteocatalog will download all the available datasets at once (this requires lots of free disk space).