Difference between revisions of "Radolan"

From BITPlan Wiki
Jump to navigation Jump to search
 
(37 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{OsProject|title=Java port of Radolan parser|url=https://github.com/BITPlan/com.bitplan.radolan|version=0.0.1}}
+
{{OsProject|id=com.bitplan.radolan|owner=BITPlan|title=Java port of Radolan parser|url=https://github.com/BITPlan/com.bitplan.radolan|version=0.0.2|date=2018-11-02}}
 
ported from golang version https://gitlab.cs.fau.de/since/radolan
 
ported from golang version https://gitlab.cs.fau.de/since/radolan
−
= Radolan =  
+
= RADOLAN =  
−
* https://www.dwd.de/DE/leistungen/radolan/radolan_info/home_freie_radolan_kartendaten.html
+
RADOLAN is the [https://de.wikipedia.org/wiki/Niederschlagsradar German Rainradar] system of [http://www.dwd.de Deutscher Wetterdienst]
 +
== DWD Information on RADOLAN ==
 +
[[File:Dwd logo 258x69.png|left|link=https://www.dwd.de]]
 +
* [https://www.dwd.de/DE/leistungen/radolan/radolan_info/home_freie_radolan_kartendaten.html Frei verfügbare RADOLAN-Daten und deren aktuelle Visualisierung: Stundensumme RW (links) und Tagessumme SF (rechts)]
 +
* [https://www.dwd.de/DE/leistungen/radolan/radolan Analysen radarbasierter stündlicher (RW) und täglicher (SF) Niederschlagshöhen ]
 +
* [https://www.dwd.de/DE/leistungen/radolan/radolan_alt RADOLAN (Radar-Online-Aneichung)]
 +
see also {{Link|target=#Documents|title=Document list below}}
  
 
== DWD Radolan Opendata ==  
 
== DWD Radolan Opendata ==  
 
* https://opendata.dwd.de/weather/radar/radolan/
 
* 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/sf/ 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/rw/ 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
+
** [https://opendata.dwd.de/weather/radar/radolan/ry/ radolan/ry - in 5 minute steps for the previous 24 hours]
 +
* ftp://ftp-cdc.dwd.de/pub/CDC/grids_germany/daily/radolan
 +
** [ftp://ftp-cdc.dwd.de/pub/CDC/grids_germany/daily/radolan/recent/ recent daily]
 +
** [ftp://ftp-cdc.dwd.de/pub/CDC/grids_germany/daily/radolan/historical/ historical]
 +
 
 +
The data is stored in proprietary file formats based on [https://en.wikipedia.org/wiki/Fortran Fortran] conventions.
 +
As of 2018-08 we did not find an open source [https://en.wikipedia.org/wiki/Java_(programming_language) Java] library to read these formats so [http://www.bitplan.com BITPlan] decided to make one available. Fortunaly Jonny Schäfer created a [https://gitlab.cs.fau.de/since/radolan golang RADOLAN library] that was quite easy to port/migrate.
 +
 
 +
The above two urls are considered "known urls" by the Radolan Java Library and access to these will lead to local caching of the data.
  
 
= First Steps =
 
= First Steps =
 
== Prerequisites ==
 
== Prerequisites ==
 
* [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Oracle Java Runtime 8]
 
* [http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html Oracle Java Runtime 8]
−
or if you'd like to build the Sprinkler software yourself:
+
or if you'd like to build the Radolan software yourself:
 
* [http://www.oracle.com/technetwork/pt/java/javase/downloads/jdk8-downloads-2133151.html Oracle Java Development Kit 8 ]
 
* [http://www.oracle.com/technetwork/pt/java/javase/downloads/jdk8-downloads-2133151.html Oracle Java Development Kit 8 ]
 
* [https://maven.apache.org/install.html Maven 3]
 
* [https://maven.apache.org/install.html Maven 3]
 +
 
== Downloads ==
 
== Downloads ==
 
* [https://github.com/BITPlan/com.bitplan.radolan/blob/master/release/radolan.jar?raw=true radolan.jar] - multiplatform Java
 
* [https://github.com/BITPlan/com.bitplan.radolan/blob/master/release/radolan.jar?raw=true radolan.jar] - multiplatform Java
Line 45: Line 60:
  
 
== Daily summary (SF) ==
 
== 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 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-18 19:50.
  
−
[[File:sf2018-08-16.png|600px]]
+
[[File:2018-08-18_1950.png|600px]]
  
 
The command to create this picture was:
 
The command to create this picture was:
 
<source lang='bash'>
 
<source lang='bash'>
−
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
+
java -jar radolan.jar -i https://opendata.dwd.de/weather/radar/radolan/sf/raa01-sf_10000-latest-dwd---bin -o 2018-08-18_1950.png -st 5
 
</source>
 
</source>
 
* <nowiki>-i</nowiki> specified the input url
 
* <nowiki>-i</nowiki> specified the input url
 
* <nowiki>-o</nowiki> specified the output image
 
* <nowiki>-o</nowiki> specified the output image
−
* <nowiki>-t</nowiki> specified the number of seconds the image should be shown
+
* <nowiki>-st</nowiki> specified the number of seconds the image should be shown
−
[https://github.com/BITPlan/com.bitplan.radolan/issues/1 as of Version 0.0.1 the software has to be stopped with CTRL-C]
+
 
 +
== Hourly sum (RW) ==
 +
The picture belows renders the https://opendata.dwd.de/weather/radar/radolan/rw/raa01-rw_10000-latest-dwd---bin file as of 2018-08-17 08:50
 +
 
 +
[[File:rw2018-08-17_0850.png|600px]]
 +
 
 +
The command to create the picture was:
 +
<source lang='bash'>
 +
java -jar radolan -i https://opendata.dwd.de/weather/radar/radolan/rw/raa01-rw_10000-1808170650-dwd---bin -o rw2018-08-17_0850.png -st 5
 +
</source>
  
 
== Historical data (SF) ==
 
== Historical data (SF) ==
Line 65: Line 89:
 
The command to create this picture was:
 
The command to create this picture was:
 
<source lang='bash'>
 
<source lang='bash'>
−
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
+
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 -st 5
 
</source>
 
</source>
 +
 
= Usage =
 
= Usage =
  
Line 76: Line 101:
  
 
   usage: java Radolan
 
   usage: java Radolan
 +
-b (--borderName) WERT : borderName
 +
                          (Vorgabe: 2_bundeslaender/2_hoch.geojson)
 
  -cp (--cachePath) WERT : path to Cache
 
  -cp (--cachePath) WERT : path to Cache
−
                           the path to the Cache
+
                           the path to the Cache (Vorgabe: /Users/wf/.radolan)
 
  -d (--debug)          : debug
 
  -d (--debug)          : debug
 
                           create additional debug output if this switch is used
 
                           create additional debug output if this switch is used
 +
                          (Vorgabe: false)
 
  -h (--help)            : help
 
  -h (--help)            : help
−
                           show this usage
+
                           show this usage (Vorgabe: true)
 
  -i (--input) WERT      : input
 
  -i (--input) WERT      : input
 
                           url/file of the input
 
                           url/file of the input
 +
-l (--location) WERT  : location/show data at the given location
 
  -nc (--noCache)        : noCache
 
  -nc (--noCache)        : noCache
−
                           do not use local cache
+
                           do not use local cache (Vorgabe: false)
 
  -o (--output) WERT    : output/e.g. path of png/jpg/gif file
 
  -o (--output) WERT    : output/e.g. path of png/jpg/gif file
 +
-p (--product) WERT    : product e.g. SF,RW,RY or alias daily,hourly,5min
 +
                          (Vorgabe: sf)
 
  -s (--show)            : show
 
  -s (--show)            : show
−
                           show resulting image
+
                           show resulting image (Vorgabe: true)
−
  -t (--showTime) N     : showTime
+
  -st (--showTime) N     : showTime
−
                           show result for the given time in seconds
+
                           show result for the given time in seconds (Vorgabe:
 +
                          1952257)
 
  -v (--version)        : showVersion
 
  -v (--version)        : showVersion
−
                           show current version if this switch is used
+
                           show current version if this switch is used (Vorgabe:
 +
                          false)
 +
-z (--zoom) N          : zoom/zoom to a grid size of zxz km (Vorgabe: 30.0)
 
</source>
 
</source>
  
Line 105: Line 139:
  
 
= Development =
 
= Development =
 +
== Using with Maven ==
 +
<source lang='xml'>
 +
<dependency>
 +
  <groupId>com.bitplan.radolan</groupId>
 +
  <artifactId>com.bitplan.radolan</artifactId>
 +
  <version>0.0.1</version>
 +
</dependency>
 +
</source>
 
== Build ==
 
== Build ==
 
<source lang='bash'>
 
<source lang='bash'>
Line 120: Line 162:
 
Results :
 
Results :
  
−
Tests run: 20, Failures: 0, Errors: 0, Skipped: 0
+
Tests run: 28, Failures: 0, Errors: 0, Skipped: 0
 
</source>
 
</source>
 +
 
== Libraries used ==
 
== Libraries used ==
 
* {{Link|target=Com.bitplan.javafx}}
 
* {{Link|target=Com.bitplan.javafx}}
  
 
== Limitations ==
 
== Limitations ==
−
The port of https://gitlab.cs.fau.de/since/radolan is not fully complete yet.
+
This java 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  
+
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 [http://www.bitplan.com/index.php/Kontaktformular BITPlan's contact form]
 +
 
 
= Credits/ Copyrights =
 
= Credits/ Copyrights =
 
== Jonny Schäfer ==
 
== Jonny Schäfer ==
Line 143: Line 187:
 
#  - legend_radar_products_pg_coordinates.pdf
 
#  - legend_radar_products_pg_coordinates.pdf
 
#  - legend_radar_products_radolan_rw_sf.pdf
 
#  - legend_radar_products_radolan_rw_sf.pdf
−
# https://www.dwd.de/DE/leistungen/radarniederschlag/rn_info/download_niederschlagsbestimmung.pdf
+
# [https://www.dwd.de/DE/leistungen/radarniederschlag/rn_info/download_niederschlagsbestimmung.pdf Niederschlagsbestimmung ]
−
#https://www.dwd.de/DE/leistungen/radolan/produktuebersicht/radolan_produktuebersicht_pdf.pdf?__blob=publicationFile&v=6
+
# [https://www.dwd.de/DE/leistungen/radolan/produktuebersicht/radolan_produktuebersicht_pdf.pdf?__blob=publicationFile&v=6 RADOLAN Produktübersicht]
 +
== Papers ==
 +
# [https://www.researchgate.net/profile/Simon_Jaeckel/publication/306239345_Wetterradar_-_Anwendungen_und_neue_Entwicklungen_Tagungsband_zum_VDI-Expertenforum_23102013_Bonn/links/57b42d0a08aeaab2a1038253/Wetterradar-Anwendungen-und-neue-Entwicklungen-Tagungsband-zum-VDI-Expertenforum-23102013-Bonn.pdf Wetterradar Anwendungen und neue Entwicklungen - VDI Expertenform 2013-10-23 Bonn - PDF]
  
 
== Radolan Infos ==
 
== Radolan Infos ==
 +
see [https://www.dwd.de/DE/leistungen/radolan/radolan_info/radolan_informationen.html?lsbId=617848 Radolan Infos Overview]
 
=== 2005 ===
 
=== 2005 ===
 
#{{RadolanInfo|1|18.01.2005}}
 
#{{RadolanInfo|1|18.01.2005}}
Line 214: Line 261:
 
== Other Libraries ==
 
== Other Libraries ==
 
* [https://gitlab.cs.fau.de/since/radolan golang Library by Jonny Schäfer of Friedrich-Alexander-Universität Erlangen-Nürnberg (FAU)]
 
* [https://gitlab.cs.fau.de/since/radolan golang Library by Jonny Schäfer of Friedrich-Alexander-Universität Erlangen-Nürnberg (FAU)]
 +
* [https://wradlib.org/ wradlib An Open Source Library for Weather Radar Data Processing]
 
* [https://github.com/jkreklow/radproc Python Library by Jennifer Kreklow University of Hannover]
 
* [https://github.com/jkreklow/radproc Python Library by Jennifer Kreklow University of Hannover]
 
* [https://github.com/meteo-ubonn/radolan Radolan C++ Library by University of Bonn]
 
* [https://github.com/meteo-ubonn/radolan Radolan C++ Library by University of Bonn]
−
 
+
* [https://github.com/brry/rdwd#rdwd rdwd R package] by [https://github.com/brry Berry Boessenkool]
 
[[Category:frontend]]
 
[[Category:frontend]]

Latest revision as of 18:15, 2 November 2018

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

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

RADOLAN

RADOLAN is the German Rainradar system of Deutscher Wetterdienst

DWD Information on RADOLAN

Dwd logo 258x69.png

see also Document list below

DWD Radolan Opendata

The data is stored in proprietary file formats based on Fortran conventions. As of 2018-08 we did not find an open source Java library to read these formats so BITPlan decided to make one available. Fortunaly Jonny Schäfer created a golang RADOLAN library that was quite easy to port/migrate.

The above two urls are considered "known urls" by the Radolan Java Library and access to these will lead to local caching of the data.

First Steps

Prerequisites

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

Downloads

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 radfilm_brd_akt.gif 

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

rad_brd_akt.jpg 

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-18 19:50.

2018-08-18 1950.png

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 2018-08-18_1950.png -st 5
  • -i specified the input url
  • -o specified the output image
  • -st specified the number of seconds the image should be shown

Hourly sum (RW)

The picture belows renders the https://opendata.dwd.de/weather/radar/radolan/rw/raa01-rw_10000-latest-dwd---bin file as of 2018-08-17 08:50

Rw2018-08-17 0850.png

The command to create the picture was: 

java -jar radolan -i https://opendata.dwd.de/weather/radar/radolan/rw/raa01-rw_10000-1808170650-dwd---bin -o rw2018-08-17_0850.png -st 5

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

Sf-2018-05-30 1650.png

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 -st 5

Usage

Commandline Arguments

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

  usage: java Radolan
 -b (--borderName) WERT : borderName
                           (Vorgabe: 2_bundeslaender/2_hoch.geojson)
 -cp (--cachePath) WERT : path to Cache
                          the path to the Cache (Vorgabe: /Users/wf/.radolan)
 -d (--debug)           : debug
                          create additional debug output if this switch is used
                          (Vorgabe: false)
 -h (--help)            : help
                          show this usage (Vorgabe: true)
 -i (--input) WERT      : input
                          url/file of the input
 -l (--location) WERT   : location/show data at the given location
 -nc (--noCache)        : noCache
                          do not use local cache (Vorgabe: false)
 -o (--output) WERT     : output/e.g. path of png/jpg/gif file
 -p (--product) WERT    : product e.g. SF,RW,RY or alias daily,hourly,5min
                          (Vorgabe: sf)
 -s (--show)            : show
                          show resulting image (Vorgabe: true)
 -st (--showTime) N     : showTime
                          show result for the given time in seconds (Vorgabe:
                          1952257)
 -v (--version)         : showVersion
                          show current version if this switch is used (Vorgabe:
                          false)
 -z (--zoom) N          : zoom/zoom to a grid size of zxz km (Vorgabe: 30.0)

Interactive Usage

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

Radolan hover 2018-08-16.png

Issues

Please report any issues via

Development

Using with Maven

<dependency>
  <groupId>com.bitplan.radolan</groupId>
  <artifactId>com.bitplan.radolan</artifactId>
  <version>0.0.1</version>
</dependency>

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: 28, Failures: 0, Errors: 0, Skipped: 0

Libraries used

Limitations

This java 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

Dwd logo 258x69.png

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

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. Niederschlagsbestimmung
  7. RADOLAN Produktübersicht

Papers

  1. Wetterradar Anwendungen und neue Entwicklungen - VDI Expertenform 2013-10-23 Bonn - PDF

Radolan Infos

see Radolan Infos Overview

2005

  1. RADOLAN Information #1 vom 18.01.2005
  2. RADOLAN Information #2 vom 18.05.2005

2007

  1. RADOLAN Information #3 vom 26.06.2007
  2. RADOLAN Information #4 vom 06.07.2007
  3. RADOLAN Information #5 vom 17.07.2007
  4. RADOLAN Information #6 vom 09.11.2007
  5. RADOLAN Information #7 vom 21.11.2007
  6. RADOLAN Information #8 vom 23.11.2007
  7. RADOLAN Information #9 vom 28.12.2007

2009

  1. RADOLAN Information #10 vom 18.05.2009
  2. RADOLAN Information #11 vom 28.05.2009

2010

  1. RADOLAN Information #12 vom 15.02.2010
  2. RADOLAN Information #13 vom 03.03.2010
  3. RADOLAN Information #14 vom 05.03.2010
  4. RADOLAN Information #15 vom 25.03.2010
  5. RADOLAN Information #16 vom 30.04.2010
  6. RADOLAN Information #17 vom 09.07.2010

2011

  1. RADOLAN Information #18 vom 07.02.2011
  2. RADOLAN Information #19 vom 16.02.2011
  3. RADOLAN Information #20 vom 06.04.2011
  4. RADOLAN Information #21 vom 01.06.2011

2012

  1. RADOLAN Information #22 vom 11.01.2012
  2. RADOLAN Information #23 vom 13.04.2012
  3. RADOLAN Information #24 vom 21.11.2012
  4. RADOLAN Information #25 vom 14.12.2012

2013

  1. RADOLAN Information #26 vom 04.04.2013
  2. RADOLAN Information #27 vom 17.06.2013
  3. RADOLAN Information #28 vom 20.06.2013
  4. RADOLAN Information #29 vom 05.07.2013
  5. RADOLAN Information #30 vom 30.08.2013
  6. RADOLAN Information #31 vom 01.10.2013
  7. RADOLAN Information #32 vom 31.10.2013
  8. RADOLAN Information #33 vom 10.12.2013
  9. RADOLAN Information #34 vom 19.12.2013

2014

  1. RADOLAN Information #35 vom 24.01.2014
  2. RADOLAN Information #36 vom 31.03.2014
  3. RADOLAN Information #37 vom 03.06.2014
  4. RADOLAN Information #38 vom 08.10.2014
  5. RADOLAN Information #39 vom 14.11.2014

2015

  1. RADOLAN Information #40 vom 02.04.2015

2016

  1. RADOLAN Information #41 vom 02.09.2016

2017

  1. RADOLAN Information #42 vom 01.02.2017
  2. RADOLAN Information #43 vom 04.09.2017
  3. RADOLAN Information #44 vom 13.09.2017
  4. RADOLAN Information #45 vom 25.10.2017

2018

  1. RADOLAN Information #46 vom 27.02.2018
  2. RADOLAN Information #47 vom 25.04.2018

Other Libraries

Retrieved from "https://wiki.bitplan.com/index.php?title=Radolan&oldid=7532"