radproc.raw.radolan_binaries_to_hdf5

radproc.raw.radolan_binaries_to_hdf5(inFolder, HDFFile, idArr=None, complevel=9)

Wrapper for radolan_binaries_to_dataframe() to import and clip all RADOLAN binary files of one month in a directory into a pandas DataFrame and save the resulting DataFrame as a dataset to an HDF5 file. The name for the HDF5 dataset is derived from the names of the input folder (year and month).

Parameters:

inFolder : string

Path to the directory containing RADOLAN binary files. As the function derives the HDF5 group and dataset names from the directory path, the latter is expected to have the following format:

>>> inFolder = "C:/path/to/binaryData/YYYY/MM"  # --> e.g. C:/Data/RADOLAN/2008/5

In this example for May 2008, the output dataset will have the path ‘2008/5’ within the HDF5 file.

HDFFile : string

Path and name of the HDF5 file. If the specified HDF5 file already exists, the new dataset will be appended; if the HDF5 file doesn’t exist, it will be created.

idArr : one-dimensional numpy array (optional, default: None)

containing ID values to select RADOLAN data of the cells located in the investigation area. If no idArr is specified, the ID array is automatically generated from RADOLAN metadata and RADOLAN precipitation data are not clipped to any investigation area.

complevel : interger (optional, default: 9)

defines the level of compression for the output HDF5 file. complevel may range from 0 to 9, where 9 is the highest compression possible. Using a high compression level reduces data size significantly, but writing data to HDF5 takes more time and data import from HDF5 is slighly slower.

Returns:

No return value

Function creates dataset in HDF5 file specified in parameter HDFFile.