Skip to main content

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)

license docs PyPI

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.

Wikipedia


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

python_install

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

Regenhöhenlinien

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

idf_analysis-0.1.11-py3-none-any.whl (28.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page