heavy rain as a function of the duration and the return period acc. to DWA-A 531 (2012)
Project description
© Institute of Urban Water Management and Landscape Water Engineering, Graz University of Technology and Markus Pichler
Intensity duration frequency analysis (based on KOSTRA)
heavy rain as a function of the duration and the return period acc. to DWA-A 531 (2012) This program reads the measurement data of the rainfall and calculates the distribution of the design rainfall as a function of the return period and the duration for duration steps up to 12 hours (and more) and return period in a range of '0.5a ≤ T_n ≤ 100a'
The guideline was used in the application KOSTRA-DWD.
Heavy rainfall data are among the most important planning parameters in water management and hydraulic engineering practice. In urban areas, for example, they are required as initial parameters for the design of rainwater drainage systems and in watercourses for the dimensioning of hydraulic structures. The accuracy of the target values of the corresponding calculation methods and models depends crucially on their accuracy. Their overestimation can lead to considerable additional costs in the structural implementation, their underestimation to an unacceptable, excessive residual risk of failure during the operation of water management and hydraulic engineering facilities. Despite the area-wide availability of heavy rainfall data through "Coordinated Heavy Rainfall Regionalisation Analyses" (KOSTRA), there is still a need for local station analyses, e.g. to evaluate the now extended data series, to evaluate recent developments or to classify local peculiarities in comparison to the KOSTRA data. However, this is only possible without restrictions if the methodological approach recommended in the worksheet is followed. In the DWA-A 531 worksheet, the main features of the ATVA 121 worksheet published in 1985 and of the identical DVWK-R 124 booklet of the DVWK Rules for Water Management "Heavy Rain Evaluation after Return Time and Duration" are retained. The aim of the revision is to take account of current developments without, however, calling into question the standardisation of the procedure for statistical heavy rain analyses which was intended at the time.
DWA-A 531 (2012) Translated with www.DeepL.com/Translator
An intensity-duration-frequency curve (IDF curve) is a mathematical function that relates the rainfall intensity with its duration and frequency of occurrence. These curves are commonly used in hydrology for flood forecasting and civil engineering for urban drainage design. However, the IDF curves are also analysed in hydrometeorology because of the interest in the time concentration or time-structure of the rainfall.
This package was originally developed from Markus Pichler's bachelor thesis and was finalised in the course of his employment at the Institute of Urban Water Management and Landscape Water Engineering.
Install
The script is written in Python3.
Windows
I recommend to use Anaconda to install python on Windows and the Anaconda-Prompt for the commandline tool.
Alternatively, you can install the original python from the website. To use the syntax explained in the usage section below, you have to add the path to your python binary to the environment variables. This is an option in the installation window as seen below:
- Add Python 3.7 to PATH
Linux/Unix
Python is pre-installed on most operating systems.
python Packages
Packages required for this program will be installed with pip during the installation process and can be seen in the 'requirements.txt' file.
Fresh install
pip install idf-analysis
To install the package only for the local user account, add --user
to the install command.
Update package
To update the package, add --upgrade
to the install command.
pip install idf-analysis --upgrade
Usage
To start the script use following commands in the terminal/Anaconda Prompt
Windows:
python -m idf_analysis
Unix-Like:
idf_analysis
The documentation of the python-API can be found here https://markuspic.github.io/intensity_duration_frequency_analysis/html/api.html.
Commandline tool
idf_analysis -h
usage: idf_analysis [-h] -i INPUT [-out OUTPUT] [-t {>= 0.5 a and <= 100 a}]
[-d {>= 5 min and <= 720 min}] [-h_N {>= 0 mm}]
[-ws {ATV-A_121,DWA-A_531,DWA-A_531_advektiv}]
[-kind {partial,annual}] [--r_720_1] [--plot]
[--extended_duration] [--export_table] [--unix]
optional arguments:
-h, --help show this help message and exit
-i INPUT, --input INPUT
input file with the rain time series
-out OUTPUT, --output OUTPUT
output path, where to write the results / default:
same as input
-t {>= 0.5 a and <= 100 a}, --return_period {>= 0.5 a and <= 100 a}
return period in years (If two of the three variables
(rainfall, duration, return period) are given, the
third variable is calculated.)
-d {>= 5 min and <= 720 min}, --duration {>= 5 min and <= 720 min}
duration in minutes (If two of the three variables
(rainfall, duration, return period) are given, the
third variable is calculated.)
-h_N {>= 0 mm}, --height_of_rainfall {>= 0 mm}
rainfall in mm or Liter/m^2 (If two of the three
variables (rainfall, duration, return period) are
given, the third variable is calculated.)
-ws {ATV-A_121,DWA-A_531,DWA-A_531_advektiv}, --worksheet {ATV-A_121,DWA-A_531,DWA-A_531_advektiv}
Worksheet used to calculate.
-kind {partial,annual}, --series_kind {partial,annual}
The kind of series used for the calculation.
Calculation with partial series is more precise
--r_720_1 design rainfall with a duration of 720 minutes (=12 h)
and a return period of 1 year
--plot get a plot of the idf relationship
--extended_duration add [720, 1080, 1440, 2880, 4320, 5760, 7200, 8640]
(in minutes) to the duration steps which will be
calculated
--export_table get a table of the most frequent used values
--unix export the csv files with a "," as separator and a "."
as decimal sign.
Example
An example jupyter notebook script can be found here: https://markuspic.github.io/intensity_duration_frequency_analysis/html/example.html
Result table
0.5 | 1.0 | 2.0 | 3.0 | 5.0 | 10.0 | 15.0 | 50.0 | 100.0 | |
---|---|---|---|---|---|---|---|---|---|
5 | 2.896502 | 4.531663 | 6.166823 | 7.123331 | 8.328387 | 9.963548 | 10.920055 | 13.760272 | 15.395433 |
10 | 5.309142 | 7.519352 | 9.729563 | 11.022454 | 12.651303 | 14.861514 | 16.154404 | 19.993464 | 22.203675 |
15 | 7.001011 | 9.637280 | 12.273549 | 13.815667 | 15.758507 | 18.394775 | 19.936894 | 24.516002 | 27.152271 |
20 | 8.229495 | 11.216989 | 14.204483 | 15.952055 | 18.153735 | 21.141229 | 22.888801 | 28.077975 | 31.065469 |
30 | 9.852722 | 13.416110 | 16.979497 | 19.063945 | 21.690039 | 25.253426 | 27.337874 | 33.527355 | 37.090743 |
45 | 11.182970 | 15.433265 | 19.683560 | 22.169823 | 25.302143 | 29.552438 | 32.038701 | 39.421316 | 43.671611 |
60 | 11.871244 | 16.687797 | 21.504351 | 24.321854 | 27.871488 | 32.688041 | 35.505544 | 43.871732 | 48.688285 |
90 | 13.636861 | 18.657189 | 23.677518 | 26.614222 | 30.314031 | 35.334359 | 38.271063 | 46.991201 | 52.011529 |
180 | 17.188203 | 22.577053 | 27.965902 | 31.118177 | 35.089574 | 40.478424 | 43.630698 | 52.990945 | 58.379794 |
270 | 19.624622 | 25.241459 | 30.858296 | 34.143934 | 38.283350 | 43.900187 | 47.185826 | 56.942078 | 62.558915 |
360 | 21.536055 | 27.320477 | 33.104900 | 36.488570 | 40.751490 | 46.535912 | 49.919582 | 59.966925 | 65.751347 |
450 | 23.132458 | 29.050305 | 34.968153 | 38.429872 | 42.791122 | 48.708969 | 52.170688 | 62.449785 | 68.367633 |
600 | 25.348627 | 31.443040 | 37.537454 | 41.102458 | 45.593832 | 51.688245 | 55.253249 | 65.839037 | 71.933450 |
720 | 26.851460 | 33.060492 | 39.269525 | 42.901576 | 47.477419 | 53.686451 | 57.318502 | 68.103378 | 74.312410 |
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for idf_analysis-0.1.7-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 685d1460d978a2215b7dffd8314928353227e9ce21cc5b5fa4218dd09fe994b0 |
|
MD5 | b9e1806bff78bb0125fa243c35aeeae5 |
|
BLAKE2b-256 | 7565920f0978fa51c2b638d76fa4bc4da45afc2eeb81b4c9695c8629b3052a63 |