Package: idf-analysis
©Institute of Urban Water Management and Landscape Water Engineering,Graz University of TechnologyandMarkus PichlerIntensity duration frequency analysis (based on KOSTRA)Heavy rain as a function of the duration and the return period acc. toDWA-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 applicationKOSTRA-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 withwww.DeepL.com/TranslatorAn 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.WikipediaThis package was developed byMarkus Pichlerduring his bachelor thesis and finalised it in the course of his employment at theInstitute of Urban Water Management and Landscape Water Engineering.DocumentationRead the docshere 📖.InstallationThis package is written in Python3. (use a version > 3.5)pip install idf-analysisAdd the following tags to the command for special options:--user: To install the package only for the local user account (no admin rights needed)--upgrade: To update the packageWindowsYou have to install python first (i.e. the original python from thewebsite).To use the command-line-tool, it is advisable to add the path to your Python binary to the environment variables^path1.
There is also an option during the installation to add python to the PATH automatically.^path2Linux/UnixPython is pre-installed on most operating systems (as you probably knew).DependenciesPackages required for this program will be installed with pip during the installation process and can be seen
in therequirements.txtfile.UsageThe documentation of the python-API can be foundhere.Commandline toolThe following commands show the usage for Linux/Unix systems.
To use these features on Windows you have to addpython -mbefore each command.To start the script use following commands in the terminal/Promptidf_analysisidf_analysis -husage: __main__.py [-h] -i INPUT
                   [-ws {ATV-A_121,DWA-A_531,DWA-A_531_advektiv}]
                   [-kind {partial,annual}] [-t {>= 0.5 a and <= 100 a}]
                   [-d {>= 5 min and <= 8640 min}] [-r {>= 0 L/s*ha}]
                   [-h_N {>= 0 mm}] [--r_720_1] [--plot] [--export_table]

heavy rain as a function of the duration and the return period acc. to DWA-A
531 (2012) All files will be saved in the same directory of the input file but
in a subfolder called like the inputfile + "_idf_data". Inside this folder a
file called "idf_parameter.yaml"-file will be saved and contains interim-
calculation-results and will be automatically reloaded on the next call.

optional arguments:
  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        input file with the rain time-series (csv or parquet)
  -ws {ATV-A_121,DWA-A_531,DWA-A_531_advektiv}, --worksheet {ATV-A_121,DWA-A_531,DWA-A_531_advektiv}
                        From which worksheet the recommendations for
                        calculating the parameters should be taken.
  -kind {partial,annual}, --series_kind {partial,annual}
                        The kind of series used for the calculation.
                        (Calculation with partial series is more precise and
                        recommended.)
  -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 (height or flow-rate), duration, return
                        period) are given, the third variable is calculated.)
  -d {>= 5 min and <= 8640 min}, --duration {>= 5 min and <= 8640 min}
                        duration in minutes (If two of the three variables
                        (rainfall (height or flow-rate), duration, return
                        period) are given, the third variable is calculated.)
  -r {>= 0 L/(s*ha)}, --flow_rate_of_rainfall {>= 0 L/(s*ha)}
                        rainfall in Liter/(s * ha) (If two of the three
                        variables (rainfall (height or flow-rate), 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 (height or flow-rate), duration,
                        return period) are given, the third variable is
                        calculated.)
  --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
  --export_table        get a table of the most frequent used valuesExampleExample Jupyter notebook for the commandlineExample Jupyter notebook for the python apiExample python skriptExample FilesInterim Results of the idf analysisExample PlotExample IDF tableIDF-Tablereturn period in aduration in min123510202530507510059.3910.9711.8913.0414.6116.1916.6917.1118.2619.1819.831015.1517.6219.0620.8823.3525.8226.6227.2729.0930.5431.561519.0322.2524.1326.5129.7232.9433.9834.8337.2039.0840.422021.8325.7127.9930.8534.7338.6239.8740.8943.7546.0247.633025.6030.6633.6237.3542.4147.4749.1050.4354.1657.1259.224528.9235.5139.3744.2350.8357.4259.5461.2866.1469.9972.736030.9338.8943.5449.4057.3665.3167.8869.9775.8380.4983.799033.3741.7446.6452.8061.1769.5472.2374.4380.6085.4988.9618038.0147.1352.4659.1868.3077.4280.3682.7689.4894.8198.6027041.0150.6056.2163.2872.8782.4685.5588.0795.14100.75104.7336043.2953.2359.0466.3776.3186.2589.4592.0699.39105.20109.3345045.1455.3661.3368.8779.0889.3092.5995.28102.81108.79113.0360047.6458.2364.4372.2382.8293.4196.8299.61107.42113.61118.0172049.2960.1366.4774.4585.2996.1299.61102.46110.44116.78121.28108054.4164.9771.1578.9489.50100.06103.46106.24114.02120.20124.58144058.0267.7273.3980.5490.2499.93103.05105.61112.75118.42122.45288066.7077.4183.6891.57102.29113.00116.45119.26127.16133.42137.87432071.9385.7293.78103.95117.73131.52135.96139.58149.75157.81163.53576078.9595.65105.42117.72134.43151.13156.50160.89173.20182.97189.90720083.53101.38111.82124.98142.83160.68166.43171.12184.28194.72202.13864085.38104.95116.40130.82150.38169.95176.25181.40195.82207.27215.39BackgroundPseudocode for the parameter calculation.For every duration step
    calculating event sums
    
    if using annual event series:  # only recommeded for measurements longer than 20 year
        converting every max event sum per year to a series
        calculating parameters u and w using the gumbel distribution
        
    elif using partial event series:
        converting the n (approximatly 2.72 x measurement duration in years) biggest event sums to a series
        calculating parameters u and w using the exponential distribution
    
Splitting IDF curve formulation in to several duration ranges
For each duration range:
    For each parameter (u and w):
        balancing the parameter over all duation steps (in the range) using a given formulation (creating parameters a and b)
        # one-folded-logaritmic | two-folded-logarithmic | hyperbolic

u(D) = f(a_u, b_u, D)
w(D) = f(a_w, b_w, D)

h(D,Tn) = u(D) + w(D) * ln(Tn)