{
    "info": {
        "author": "Markus Pichler",
        "author_email": "markus.pichler@tugraz.at",
        "bugtrack_url": null,
        "classifiers": [
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3"
        ],
        "description": "\u00a9 [Institute of Urban Water Management and Landscape Water Engineering](https://www.tugraz.at), [Graz University of Technology](https://www.tugraz.at/home/) and [Markus Pichler](mailto:markus.pichler@tugraz.at)\n\n# eHYD Tools\nVarious tools for exporting and analyzing >10a rain time-series from the [ehyd.gv.at](https://ehyd.gv.at) platform of the Austian government.\n\nIf you are interested in a statistical heavy rain analysis like on *(\u00d6)Kostra*, take a look at my other python package [intensity_duration_frequency_analysis](https://github.com/MarkusPic/intensity_duration_frequency_analysis) which is compatible with this package.\n\n# Install\n\nThe script is written in Python3.\n\n## Windows\n\nI recommend to use [Anaconda](https://www.anaconda.com/download/) to install python on Windows and the Anaconda-Prompt for the commandline tool.\n\nAlternatively, you can install the original python from the [website](https://www.python.org/downloads/).\nTo use the syntax explained in the usage section below, \nyou have to add the path to your python binary to the environment variables. \nThis is an option in the installation window as seen below:\n\n- [x] Add Python 3.7 to PATH\n\n![python_install](example/python_install.png)\n\n## Linux/Unix\n\nPython is pre-installed on most operating systems.\n\n## Required python packages\n\nPackages required for this program will be installed with pip during the installation process and can be seen in the 'requirements.txt' file.\n\n## Fresh install\n\n\n```\npip install ehyd-tools\n```\n\nAdd the following tags to the command for special options:\n\n- ```--user```: To install the package only for the local user account\n- ```--upgrade```: To update the package\n\n# Usage\n\nTo start the script use following commands in the terminal/Prompt\n\nWindows:\n```python -m ehyd_tools```\n\nUnix-Like:\n```ehyd_tools```\n\n## Commandline tool \n\n```ehyd_tools -h```\n\n> ```\n> usage: ehyd_tools [-h] [-id ID] [--input INPUT] [--add_gaps] [--to_csv]\n>                   [--to_parquet] [--max10a] [--start START] [--end END]\n>                   [--plot] [--statistics] [--meta] [--unix]\n> \n> optional arguments:\n>   -h, --help     show this help message and exit\n>   -id ID         the id number for the station from the ehyd.gv.at platform\n>   --input INPUT  path to the rain input file including the filename\n>   --add_gaps     get the gaps in the series as a csv table\n>   --to_csv       save the data to the current directory\n>   --to_parquet   save the data to the current directory\n>   --max10a       consider only 10 years with the most availability\n>   --start START  custom start time, Format=\"YYYY-MM-DD\"\n>   --end END      custom end time, Format=\"YYYY-MM-DD\"\n>   --plot         plot the data\n>   --statistics   creates a txt file with basic statistics (sum, max & min)\n>   --meta         add the txt file with the meta data of the ehyd data\n>   --unix         export the csv files with a \",\" as separator and a \".\" as\n>                  decimal sign.\n> ```\n\n## Examples\n\n### Example 1\n\n```ehyd_tools -id 100180 --to_csv --max10a --add_gaps```\n\nThe results will be:\n\nFirst the name of the station will be printed to the terminal.\n\n```You choose the station: \"Tschagguns\" with the id: \"100180\".```\n\nBecause of the ```--max10a``` argument, the series will get a new start and end time base on the maximum availability.\n\n```Data was clipped to start=\"1982-04-30\" and end=\"1992-04-30\".```\n\nThe standard filename of the output-files starts with *ehyd_\\<ID\\>*.\n\nAll the files will be created in the current directory.\n\nWith the ```--add_gaps``` argument, a csv file of the gaps in the series with the name *ehyd_\\<ID\\>_gaps.csv* will be created.\n\nWith the ```--to_csv``` argument, a csv file of the series with the name *ehyd_\\<ID\\>.csv* will be created.\n\nAfter the command above two files will be created:\n\n> ehyd_100180.csv\n>\n> ehyd_100180_gaps.csv\n\n```\n;start;end;gaps in days\n8;1961-10-27 06:58:00;1962-05-16 07:00:00;201,001\n20;1972-10-19 06:58:00;1973-05-02 07:00:00;195,001\n5;1958-11-01 07:01:00;1959-05-15 07:00:00;194,999\n2;1955-10-23 07:01:00;1956-05-01 07:00:00;190,999\n22;1974-10-27 06:58:00;1975-05-05 07:00:00;190,001\n0;1953-11-01 06:59:00;1954-05-06 07:01:00;186,001\n13;1966-11-01 06:59:00;1967-05-04 07:00:00;184,001\n27;1979-10-31 06:58:00;1980-05-01 07:00:00;183,001\n23;1975-10-31 06:58:00;1976-05-01 07:00:00;183,001\n12;1965-10-31 06:58:00;1966-05-01 07:00:00;182,001\n21;1973-11-01 06:59:00;1974-05-01 07:01:00;181,001\n29;1981-11-01 06:59:00;1982-05-01 07:01:00;181,001\n26;1978-10-31 06:58:00;1979-04-25 07:01:00;176,002\n15;1968-10-31 06:58:00;1969-04-24 07:00:00;175,001\n3;1956-10-26 07:01:00;1957-04-19 07:00:00;174,999\n7;1960-10-14 06:59:00;1961-04-04 07:00:00;172,001\n9;1962-11-01 06:59:00;1963-04-19 07:00:00;169,001\n25;1977-11-14 06:58:00;1978-05-01 07:02:00;168,003\n10;1963-11-01 06:59:00;1964-04-15 07:00:00;166,001\n19;1971-10-31 06:58:00;1972-04-13 07:00:00;165,001\n24;1976-11-20 06:59:00;1977-05-01 07:00:00;162,001\n1;1954-11-06 06:59:00;1955-04-16 07:00:00;161,001\n6;1959-10-26 06:58:00;1960-04-01 07:00:00;158,001\n4;1957-10-31 06:58:00;1958-04-01 07:00:00;152,001\n14;1967-11-01 07:01:00;1968-04-01 07:00:00;151,999\n18;1970-11-01 06:59:00;1971-04-01 07:00:00;151,001\n11;1964-11-16 06:59:00;1965-04-01 07:00:00;136,001\n17;1970-01-01 00:00:00;1970-04-30 07:00:00;119,292\n16;1969-10-31 06:58:00;1970-01-01 00:00:00;61,710\n28;1981-01-01 06:59:00;1981-03-01 07:01:00;59,001\n```\n\n\n### Example 2\n\n```ehyd_tools -id 100180 --plot```\n\nWith the ```--plot``` argument, a png file of the series bar plot with the name *ehyd_\\<ID\\>_plot.png* will be created.\n\nFor data series longer than 15 years, annual sums, otherwise monthly sums, are used.\n\nAfter the command above these file will be created:\n\n> ehyd_100180_plot.png\n\n![Regenh\u00f6henlinien](example/ehyd_100180_plot.png)\n\n### Example 3\n\n```ehyd_tools -id 100180 --meta --statistics```\n\nWith the ```--meta``` argument, a txt file containing the meta data with the name *ehyd_\\<ID\\>_meta.txt* will be created.\n\nWith the ```--statistics``` argument, a txt file containing the statistics of the series with the name *ehyd_\\<ID\\>_stats.txt* will be created.\n\nAfter the command above these two files will be created:\n\n\n> ehyd_100180_meta.txt\n\n```\nMessstelle:                Tschagguns\nHZB-Nummer:                100180\nErrichtet:                 1921\n\nSachgebiet:                NLV\nDienststelle:              HD-Vorarlberg\nMessstellenbetreiber:      Hydrographischer Dienst\n\nH\u00f6he:\n g\u00fcltig seit:              H\u00f6he [m \u00fc.A.]:\n  01.08.1921               681\n\nGeographische Koordinaten (Referenzellipsoid: Bessel 1841):\n g\u00fcltig seit:              L\u00e4nge (Grad,Min,Sek):    Breite  (Grad,Min,Sek):\n  01.08.1921               09 54 57                 47 04 03\n\nMessgr\u00f6\u00dfen,-art:           seit:     bis:\n  Niederschlag-Ombrometer  1921\n  Niederschlag-Ombrograph  1953\n  Schneeh\u00f6he               1921\n  Neuschneeh\u00f6he            1921\n  Temperatur               1922\n```\n\n> ehyd_100180_stats.txt\n\n```\nThe annual totals of the data series serve as the data basis.\nThe following statistics were analyzed:\n\nThe maximum is 1740 mm and was in the year 1999 (with 100% Data available).\nThe minimum is 462 mm and was in the year 1959 (with 45% Data available).\nThe mean is 1030 mm (with 77% Data available in average).\n```\n\n\n## The stations\n\n|id      |                      station|\n|--------|-----------------------------|\n|100180  |                   Tschagguns|\n|100370  |                    Th\u00fcringen|\n|100446  |                     Lustenau|\n|100479  |                     Dornbirn|\n|100776  |                      Bregenz|\n|101303  |         Leutasch-Kirchplatzl|\n|101816  |                 Ladis-Neuegg|\n|102772  |                     Kelchsau|\n|103143  |  St. Johann in Tirol-Almdorf|\n|103895  |                    Eugendorf|\n|104604  |                      Schl\u00e4gl|\n|104877  |                  Linz-Urfahr|\n|105445  |                  V\u00f6cklabruck|\n|105528  |                         Wels|\n|105908  |                      Flachau|\n|106112  |                       Liezen|\n|106252  |                    Wildalpen|\n|106435  |       Klaus an der Pyhrnbahn|\n|106559  |                        Steyr|\n|106856  |      Weitersfelden-Ritzenedt|\n|107029  |                  Lunz am See|\n|107284  |                         Melk|\n|107854  |                   Hollabrunn|\n|108118  |    Wien (Botanischer Garten)|\n|108456  |                   Gutenstein|\n|108563  |                      Naglern|\n|109280  |       Waidhofen an der Thaya|\n|109918  |                  Neunkirchen|\n|110064  |                   Gattendorf|\n|110312  |                         Karl|\n|110734  |                   Eisenstadt|\n|111112  |                     Oberwart|\n|111435  |                         Alpl|\n|111716  |                    Judenburg|\n|112086  |                 Graz-Andritz|\n|112391  |       St.Peter am Ottersbach|\n|112995  |             Ried im Innkreis|\n|113001  |                      Sillian|\n|113050  |           Matrei in Osttirol|\n|113548  |                       Afritz|\n|113670  |                      Waidegg|\n|114561  |                   Klagenfurt|\n|114702  |                    Wolfsberg|\n|115055  |                   Kendlbruck|\n|115642  |                    St.P\u00f6lten|\n|120022  |                Hall in Tirol|\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/MarkusPic/ehyd_tools",
        "keywords": "",
        "license": "MIT",
        "maintainer": "",
        "maintainer_email": "",
        "name": "ehyd-tools",
        "package_url": "https://pypi.org/project/ehyd-tools/",
        "platform": "",
        "project_url": "https://pypi.org/project/ehyd-tools/",
        "project_urls": {
            "Homepage": "https://github.com/MarkusPic/ehyd_tools"
        },
        "release_url": "https://pypi.org/project/ehyd-tools/0.1.dev4/",
        "requires_dist": [
            "numpy",
            "pandas",
            "matplotlib",
            "requests"
        ],
        "requires_python": "",
        "summary": "Various tools for exporting and analyzing >10a rain time-series from the \"ehyd.gv.at\" platform of the Austian government.",
        "version": "0.1.dev4"
    },
    "last_serial": 5707291,
    "releases": {
        "0.1.dev0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b2755645dc04c1da1d34767ad9ecc3df",
                    "sha256": "45eac301cc5049bd764f1cf70fc875f152d24ed9eb0c751412567532e540bcb8"
                },
                "downloads": -1,
                "filename": "ehyd_tools-0.1.dev0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b2755645dc04c1da1d34767ad9ecc3df",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 16439,
                "upload_time": "2019-05-30T12:53:06",
                "url": "https://files.pythonhosted.org/packages/5c/5f/0e3a40d1d3c13cfa0baeb9b340a9b8a009029c1c2ac79e2486cf5e58c710/ehyd_tools-0.1.dev0-py3-none-any.whl"
            }
        ],
        "0.1.dev1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "79322dd25dd72c90d83047d389c77443",
                    "sha256": "54f47643ad75ed9f37413d99636a4a31e450cc1911e7835b01b0c737c4a08b43"
                },
                "downloads": -1,
                "filename": "ehyd_tools-0.1.dev1-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "79322dd25dd72c90d83047d389c77443",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 16441,
                "upload_time": "2019-05-30T13:00:22",
                "url": "https://files.pythonhosted.org/packages/cb/c2/678f9f268b6ec786f5892a49a3e27c6b6db1ca33a107c66a8d0fb2500a6e/ehyd_tools-0.1.dev1-py3-none-any.whl"
            }
        ],
        "0.1.dev2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "77d0ce0c22625130bb35ea8aed7059ad",
                    "sha256": "245c47d1119bc929e8de06319dac4e49647c6f6c93a1d9c6bd3606a923b8ae16"
                },
                "downloads": -1,
                "filename": "ehyd_tools-0.1.dev2-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "77d0ce0c22625130bb35ea8aed7059ad",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 16966,
                "upload_time": "2019-08-20T12:23:54",
                "url": "https://files.pythonhosted.org/packages/9f/db/11974ff2a414044843f37fa1e76635b41ac49dbbf5feab29acb6989a7fc9/ehyd_tools-0.1.dev2-py3-none-any.whl"
            }
        ],
        "0.1.dev3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "ed3b8edb8cac74456f57bbf65cfc8773",
                    "sha256": "be985ad0527bad0adf71bed0489308ff3c03dd8be9c7376e1d4f099d7b3ce4d6"
                },
                "downloads": -1,
                "filename": "ehyd_tools-0.1.dev3-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "ed3b8edb8cac74456f57bbf65cfc8773",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 16979,
                "upload_time": "2019-08-20T12:33:11",
                "url": "https://files.pythonhosted.org/packages/3e/ab/d554a0cd8492606285f9417e5855635185b1b4b60bcaaac1a216046fc36d/ehyd_tools-0.1.dev3-py3-none-any.whl"
            }
        ],
        "0.1.dev4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "953f0b579dd0715052b767eb7ab9474a",
                    "sha256": "01bec795459964001217c1bd25f608d09864ec4ef53fe16c3f45533a40c4fb5f"
                },
                "downloads": -1,
                "filename": "ehyd_tools-0.1.dev4-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "953f0b579dd0715052b767eb7ab9474a",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 17291,
                "upload_time": "2019-08-21T06:36:08",
                "url": "https://files.pythonhosted.org/packages/e1/e9/b51f5439226b6c1806f174fd09a2ccca38dd925ae8ca65190f390b96c9f6/ehyd_tools-0.1.dev4-py3-none-any.whl"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "953f0b579dd0715052b767eb7ab9474a",
                "sha256": "01bec795459964001217c1bd25f608d09864ec4ef53fe16c3f45533a40c4fb5f"
            },
            "downloads": -1,
            "filename": "ehyd_tools-0.1.dev4-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "953f0b579dd0715052b767eb7ab9474a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 17291,
            "upload_time": "2019-08-21T06:36:08",
            "url": "https://files.pythonhosted.org/packages/e1/e9/b51f5439226b6c1806f174fd09a2ccca38dd925ae8ca65190f390b96c9f6/ehyd_tools-0.1.dev4-py3-none-any.whl"
        }
    ]
}