radproc.wradlib_io.read_RADOLAN_composite

radproc.wradlib_io.read_RADOLAN_composite(fname, missing=-9999, loaddata=True)

Read quantitative radar composite format of the German Weather Service

The quantitative composite format of the DWD (German Weather Service) was established in the course of the RADOLAN project and includes several file types, e.g. RW, YW, RY, RX, RZ, and many, many more. (see format description on the RADOLAN project homepage).

Originally, the national RADOLAN composite was a 900 x 900 grid with 1 km resolution and in polar-stereographic projection. But for the reanalysis within the radar climatology project finished in 2017 the national grid was extended to 1100 x 900 cells. There are other grid resolutions for other composites, too (e.g. PC, PG).

This function already evaluates and applies the so-called PR factor which is specified in the header section of the RADOLAN files. The raw values in an RY oder YW file are in the unit 0.01 mm/5min, while read_RADOLAN_composite returns values in mm/5min (i. e. factor 100 higher). The factor is also returned as part of attrs dictionary under keyword “precision”.

fname : string
path to the composite file
missing : int
value assigned to no-data cells
loaddata : bool
True | False, If False function returns (None, attrs)
output : tuple

tuple of two items (data, attrs):

  • data : numpy array of shape (number of rows, number of columns)
  • attrs : dictionary of metadata information from the file header