ehyd-tools 0.1.dev7

Various tools for exporting and analyzing >10a rain time-series from the "ehyd.gv.at" platform of the Austian government.

© Institute of Urban Water Management and Landscape Water Engineering, Graz University of Technology and Markus Pichler

eHYD Tools

Various tools for exporting and analyzing >10a rain time-series from the ehyd.gv.at platform of the Austian government.

If you are interested in a statistical heavy rain analysis like on (Ö)Kostra, take a look at my other python package intensity_duration_frequency_analysis which is compatible with this package.

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

Commandline usage in windows

The following commands show the usage on Linux/Unix systems. To use these features on Windows you must add python -m before each command. This way you can use Python scripts from the commandline.

Linux/Unix

Python is pre-installed on most operating systems.

Required 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 ehyd-tools

Add 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 package

Usage

To start the script use following commands in the terminal/Prompt

ehyd_tools

Commandline tool

With the -h (help) flag you can see the complete functionality of the tool.

ehyd_tools -h

usage: ehyd_tools [-h] [-id ID] [--input INPUT] [--add_gaps] [--to_csv]
                  [--to_parquet] [--max10a] [--start START] [--end END]
                  [--plot] [--statistics] [--meta] [--unix]

optional arguments:
  -h, --help     show this help message and exit
  -id ID         the id number for the station from the ehyd.gv.at platform
  --input INPUT  path to the rain input file including the filename
  --add_gaps     get the gaps in the series as a csv table
  --to_csv       save the data to the current directory
  --to_parquet   save the data to the current directory
  --max10a       consider only 10 years with the most availability
  --start START  custom start time, Format="YYYY-MM-DD"
  --end END      custom end time, Format="YYYY-MM-DD"
  --plot         plot the data
  --statistics   creates a txt file with basic statistics (sum, max & min)
  --meta         add the txt file with the meta data of the ehyd data
  --unix         export the csv files with a "," as separator and a "." as
                 decimal sign.

Examples

Example 1

ehyd_tools -id 100180 --to_csv --max10a --add_gaps

The results will be:

First the name of the station will be printed to the terminal.

You choose the station: "Tschagguns" with the id: "100180".

Because of the --max10a argument, the series will get a new start and end time base on the maximum availability.

Data was clipped to start="1982-04-30" and end="1992-04-30".

The standard filename of the output-files starts with ehyd_<ID>.

All the files will be created in the current directory.

With the --add_gaps argument, a csv file of the gaps in the series with the name ehyd_<ID>_gaps.csv will be created.

With the --to_csv argument, a csv file of the series with the name ehyd_<ID>.csv will be created.

After the command above two files will be created:

ehyd_100180.csv

ehyd_100180_gaps.csv

;start;end;gaps in days
8;1961-10-27 06:58:00;1962-05-16 07:00:00;201,001
20;1972-10-19 06:58:00;1973-05-02 07:00:00;195,001
5;1958-11-01 07:01:00;1959-05-15 07:00:00;194,999
2;1955-10-23 07:01:00;1956-05-01 07:00:00;190,999
22;1974-10-27 06:58:00;1975-05-05 07:00:00;190,001
0;1953-11-01 06:59:00;1954-05-06 07:01:00;186,001
13;1966-11-01 06:59:00;1967-05-04 07:00:00;184,001
27;1979-10-31 06:58:00;1980-05-01 07:00:00;183,001
23;1975-10-31 06:58:00;1976-05-01 07:00:00;183,001
12;1965-10-31 06:58:00;1966-05-01 07:00:00;182,001
21;1973-11-01 06:59:00;1974-05-01 07:01:00;181,001
29;1981-11-01 06:59:00;1982-05-01 07:01:00;181,001
26;1978-10-31 06:58:00;1979-04-25 07:01:00;176,002
15;1968-10-31 06:58:00;1969-04-24 07:00:00;175,001
3;1956-10-26 07:01:00;1957-04-19 07:00:00;174,999
7;1960-10-14 06:59:00;1961-04-04 07:00:00;172,001
9;1962-11-01 06:59:00;1963-04-19 07:00:00;169,001
25;1977-11-14 06:58:00;1978-05-01 07:02:00;168,003
10;1963-11-01 06:59:00;1964-04-15 07:00:00;166,001
19;1971-10-31 06:58:00;1972-04-13 07:00:00;165,001
24;1976-11-20 06:59:00;1977-05-01 07:00:00;162,001
1;1954-11-06 06:59:00;1955-04-16 07:00:00;161,001
6;1959-10-26 06:58:00;1960-04-01 07:00:00;158,001
4;1957-10-31 06:58:00;1958-04-01 07:00:00;152,001
14;1967-11-01 07:01:00;1968-04-01 07:00:00;151,999
18;1970-11-01 06:59:00;1971-04-01 07:00:00;151,001
11;1964-11-16 06:59:00;1965-04-01 07:00:00;136,001
17;1970-01-01 00:00:00;1970-04-30 07:00:00;119,292
16;1969-10-31 06:58:00;1970-01-01 00:00:00;61,710
28;1981-01-01 06:59:00;1981-03-01 07:01:00;59,001

Example 2

ehyd_tools -id 100180 --plot

With the --plot argument, a png file of the series bar plot with the name ehyd_<ID>_plot.png will be created.

For data series longer than 15 years, annual sums, otherwise monthly sums, are used.

After the command above these file will be created:

ehyd_100180_plot.png

Example 3

ehyd_tools -id 100180 --meta --statistics

With the --meta argument, a txt file containing the meta data with the name ehyd_<ID>_meta.txt will be created.

With the --statistics argument, a txt file containing the statistics of the series with the name ehyd_<ID>_stats.txt will be created.

After the command above these two files will be created:

ehyd_100180_meta.txt

Messstelle:                Tschagguns
HZB-Nummer:                100180
Errichtet:                 1921

Sachgebiet:                NLV
Dienststelle:              HD-Vorarlberg
Messstellenbetreiber:      Hydrographischer Dienst

Höhe:
 gültig seit:              Höhe [m ü.A.]:
  01.08.1921               681

Geographische Koordinaten (Referenzellipsoid: Bessel 1841):
 gültig seit:              Länge (Grad,Min,Sek):    Breite  (Grad,Min,Sek):
  01.08.1921               09 54 57                 47 04 03

Messgrößen,-art:           seit:     bis:
  Niederschlag-Ombrometer  1921
  Niederschlag-Ombrograph  1953
  Schneehöhe               1921
  Neuschneehöhe            1921
  Temperatur               1922

ehyd_100180_stats.txt

The annual totals of the data series serve as the data basis.
The following statistics were analyzed:

The maximum is 1740 mm and was in the year 1999 (with 100% Data available).
The minimum is 462 mm and was in the year 1959 (with 45% Data available).
The mean is 1030 mm (with 77% Data available in average).

The stations

id	station
100180	Tschagguns
100370	Thüringen
100446	Lustenau
100479	Dornbirn
100776	Bregenz
101303	Leutasch-Kirchplatzl
101816	Ladis-Neuegg
102772	Kelchsau
103143	St. Johann in Tirol-Almdorf
103895	Eugendorf
104604	Schlägl
104877	Linz-Urfahr
105445	Vöcklabruck
105528	Wels
105908	Flachau
106112	Liezen
106252	Wildalpen
106435	Klaus an der Pyhrnbahn
106559	Steyr
106856	Weitersfelden-Ritzenedt
107029	Lunz am See
107284	Melk
107854	Hollabrunn
108118	Wien (Botanischer Garten)
108456	Gutenstein
108563	Naglern
109280	Waidhofen an der Thaya
109918	Neunkirchen
110064	Gattendorf
110312	Karl
110734	Eisenstadt
111112	Oberwart
111435	Alpl
111716	Judenburg
112086	Graz-Andritz
112391	St.Peter am Ottersbach
112995	Ried im Innkreis
113001	Sillian
113050	Matrei in Osttirol
113548	Afritz
113670	Waidegg
114561	Klagenfurt
114702	Wolfsberg
115055	Kendlbruck
115642	St.Pölten
120022	Hall in Tirol