Usage

Download RADOLAN data from {current-year}-01-01 till today to current directory with raddo. For further arguments consult the help text:

Example

Download RADOLAN data to folder1 (-d) from 2020-07-15 (-s) until yesterday (default) for point in shapefile test_pt.shp (-m). Sort and extract nested archives and create GeoTiffs and a single NetCDF file from there (-C). Don’t check for available files but just download all needed files (-D):

raddo -d "folder1" -s "2020-07-15" -CD -m "test_pt.shp"

More visual:

example image should load here…

Warnings

• currently, if a shapefile mask is used, sub-optimal nearest neighbour resampling is applied in the GeoTiff conversion (as other methods were not functional in gdal python bindings..(?)).

• if GeoTiffs are not wanted, they need to be created anyways, and processing might fill up your tempfs in /tmp..

• if multiple polygons are used as mask, they are dissolved & buffered.

• raddo does not recreate nor warn if GeoTiffs are already available.

Docker

raddo then can be used from within the docker container like this:

docker run -ti --rm  -v /tmp/RADOLAN:/data raddo -C -s "20210422"

• -ti: docker runs in an interactive tty

• --rm: the container is destroyed after usage

• -v /tmp/RADOLAN:/data: an existing folder (/tmp/RADOLAN) is connected to the container (internal folder /data) - If asked accept to save the data in /data

• raddo: image name, that automatically starts the raddo program

• -C -s ....: after the image name, additional arguments for raddo can be added, here: - -C: complete processing - -s "20210422": starting date

The data can then be found in the linked folder, e.g. /tmp/RADOLAN.

Crontab

Note

This part is outdated:

An entry in crontab could be used to download/mirror the data. E.g.:

0 12 * * 1-5 raddo -fx -d /path/to/radolan/data/

The following skript (Anaconda is used as python distribution) can be used to log

#!/usr/bin/env bash
export PATH="$HOME/.anaconda3/bin:$PATH"
DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
date=$(date)
header="\n--------------------------\n"$date" executing raddo:\n"
echo -e $header >> $DIR"/raddo.log"
python ~/path/to/raddo/raddo.py &>> $DIR"/raddo.log"

This adds the anaconda path to the $PATH variable. Furthermore, it uses the directory which the shell script is executed from as $DIR to write/append the $headerand stdout to a custom log file (raddo.log).

Python script

import raddo as rd

rd.radolan_down(rad_dir_dwd = ...,  )

Variables and their defaults are:

PARAMETERS:
-------------------------
    rad_dir_dwd: string
        Link to Radolan products on DWD FTP server.
        defaults to "https://opendata.dwd.de/climate_environment/CDC/
                     grids_germany/hourly/radolan/recent/asc/")

    rad_dir_dwd_hist: string
        Link to Radolan products on DWD FTP server.
        defaults to "https://opendata.dwd.de/climate_environment/CDC/"
                    "grids_germany/hourly/radolan/historical/asc/"

    rad_dir: string
        local directory to be processed / already containing radolan data.
        defaults to current working directory

    start_date: string
        parsable date string (default: 14 days ago)

    end_date: string
        parsable date string (default: yesterday)

    errors_allowed: integer
        number of tries to download one file (default: 5)

    force:
        Forces local file search. Omits faster check of
        .raddo_local_files.txt".

    force_down:
        Forces download of all files.

    mask:
        Mask shapefile.

    buffer:
        Buffer in meter around shapefile mask.