Radolan

OsProject
id
state
owner
title	Java port of Radolan parser
url	https://github.com/BITPlan/com.bitplan.radolan
version	0.0.1
description
date
since
until

ported from golang version https://gitlab.cs.fau.de/since/radolan

Radolan

• https://www.dwd.de/DE/leistungen/radolan/radolan_info/home_freie_radolan_kartendaten.html

DWD Radolan Opendata

• https://opendata.dwd.de/weather/radar/radolan/
• https://opendata.dwd.de/weather/radar/radolan/sf/ daily sum - in hour steps for the previous 48 hours
• https://opendata.dwd.de/weather/radar/radolan/rw/ hourly sum - in hour steps for the previous 48 hours
• https://opendata.dwd.de/weather/radar/radolan/ry/ - in 5 minute steps for the previous 24 hours

First Steps

Prerequisites

• Oracle Java Runtime 8

or if you'd like to build the Sprinkler software yourself:

• Oracle Java Development Kit 8
• Maven 3

Downloads

• radolan.jar - multiplatform Java
• radolan.exe - Windows executable

Installation

Make sure the prerequisites are checked. Download the software for your platform from #Downloads or build the software yourself

Starting

Run the software with

java -jar radolan.jar

or radolan (If you built the software yourself: cd com.bitplan.radolan/release before this command).

Examples

Radar film

Calling radolan with no arguments will show the current DWD radar film

java -jar release/radolan.jar

which is equivalent to

java -jar release/radolan.jar -i https://www.dwd.de/DWD/wetter/radar/radfilm_brd_akt.gif

Radar snapshot

java -jar release/radolan.jar -i https://www.dwd.de/DWD/wetter/radar/rad_brd_akt.jpg

Daily summary (SF)

The picture below renders the https://opendata.dwd.de/weather/radar/radolan/sf/raa01-sf_10000-latest-dwd---bin radolan SF file as of 2018-08-16 22:50.

The command to create this picture was:

java -jar radolan.jar -i https://opendata.dwd.de/weather/radar/radolan/sf/raa01-sf_10000-latest-dwd---bin -o sf2018-08-16.png -t 5

• -i specified the input url
• -o specified the output image
• -t specified the number of seconds the image should be shown

as of Version 0.0.1 the software has to be stopped with CTRL-C

Historical data (SF)

The picture below renders the ftp://ftp-cdc.dwd.de/pub/CDC/grids_germany/daily/radolan/recent/raa01-sf_10000-1805301650-dwd---bin.gz SF files as of 2018-05-30 16:50

The command to create this picture was:

java -jar radolan.jar -i ftp://ftp-cdc.dwd.de/pub/CDC/grids_germany/daily/radolan/recent/raa01-sf_10000-1805301650-dwd---bin.gz -o sf-2018-05-30_1650.png -t 5

Usage

Commandline Arguments

java -jar release/radolan.jar -h
Help
Radolan: 0.0.1

  usage: java Radolan
 -cp (--cachePath) WERT : path to Cache
                          the path to the Cache
 -d (--debug)           : debug
                          create additional debug output if this switch is used
 -h (--help)            : help
                          show this usage
 -i (--input) WERT      : input
                          url/file of the input
 -nc (--noCache)        : noCache
                          do not use local cache
 -o (--output) WERT     : output/e.g. path of png/jpg/gif file
 -s (--show)            : show
                          show resulting image
 -t (--showTime) N      : showTime
                          show result for the given time in seconds
 -v (--version)         : showVersion
                          show current version if this switch is used

Interactive Usage

When you hover over a picture the location and amount of precipitation at the given position will be displayed as a tooltip.

Issues

Please report any issues via

• https://github.com/BITPlan/com.bitplan.radolan/issues

Development

Build

git clone https://github.com/BITPlan/com.bitplan.radolan
cd com.bitplan.radolan
mvn install -D skipTests

The resulting jar and exe files are in the release subdirectory.

Test

cd com.bitplan.radolan
mvn test
...
Results :

Tests run: 20, Failures: 0, Errors: 0, Skipped: 0

Libraries used

• Com.bitplan.javafx

Limitations

The port of https://gitlab.cs.fau.de/since/radolan is not fully complete yet. E.g. the RunLength and SingleByte Encodings have not been ported yet. You are welcome to send a pullrequest to incorporate this functionality or ask for help via BITPlan's contact form

Credits/ Copyrights

Jonny Schäfer

Thanks to Jonny Schäfer of the Computer Science Department of Friedrich-Alexander-Universität Erlangen-Nürnberg (FAU) for the golang radolan implementation on which this project is based.

DWD

This project is based on copyrighted and open sourced material from Deutscher Wetterdienst. You may only use it in conformance with

• DWD Copyright

Links

Documents

1. https://www.dwd.de/DE/leistungen/radolan/radolan_info/radolan_radvor_op_komposit_format_pdf.pdf
2. https://www.dwd.de/DE/leistungen/gds/weiterfuehrende_informationen.zip
3. - legend_radar_products_fz_forecast.pdf
4. - legend_radar_products_pg_coordinates.pdf
5. - legend_radar_products_radolan_rw_sf.pdf
6. https://www.dwd.de/DE/leistungen/radarniederschlag/rn_info/download_niederschlagsbestimmung.pdf

Radolan Infos

1. 2
2. 3

Other Libraries

• golang Library by Jonny Schäfer of Friedrich-Alexander-Universität Erlangen-Nürnberg (FAU)
• Python Library by Jennifer Kreklow University of Hannover
• Radolan C++ Library by University of Bonn