{ "info": { "author": "Martin Roberge", "author_email": "mroberge.whois@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Science/Research", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Scientific/Engineering :: Information Analysis", "Topic :: Scientific/Engineering :: Visualization", "Topic :: Utilities" ], "description": "===============================\nHydroFunctions\n===============================\n\n.. image:: https://img.shields.io/pypi/v/hydrofunctions.svg\n :target: https://pypi.python.org/pypi/hydrofunctions\n :alt: Visit Hydrofunctions on PyPI\n\n.. image:: https://img.shields.io/travis/mroberge/hydrofunctions.svg\n :target: https://travis-ci.org/mroberge/hydrofunctions\n :alt: Unit Testing Status\n\n.. image:: https://codecov.io/gh/mroberge/hydrofunctions/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/mroberge/hydrofunctions\n :alt: Code Coverage Status\n\n.. image:: https://readthedocs.org/projects/hydrofunctions/badge/?version=latest\n :target: https://hydrofunctions.readthedocs.io/en/latest/?badge=latest\n :alt: Documentation Status\n\n.. image:: https://img.shields.io/github/license/mashape/apistatus.svg\n :target: https://github.com/mroberge/hydrofunctions/blob/master/LICENSE\n :alt: MIT license\n\na suite of convenience functions for exploring water data in Python.\n\nFeatures\n--------\n\n* Retrieves stream data from the USGS NWIS service\n* Retrieve data using multiple site numbers, state, county codes, or boundary box\n* Preserves NWIS metadata, including NoData values\n* Helpful error messages to help you write valid requests\n* Extracts data into a Pandas dataframe, json, or dict\n* Plotting and manipulation through Pandas dataframes\n* Interactive map for finding stream gage ID numbers\n* Still in early development! More features to come!\n\nRead the `Users Guide `_ for more details.\n\n\nBasic Usage\n-----------\n\nFirst, import hydrofunctions into your project and enable automatic chart \ndisplay::\n\n >>> import hydrofunctions as hf\n >>> %matplotlib inline\n\nCreate NWIS data object to hold our request and the data we will retrieve.\nWe will request the daily values ('dv') for site '0158520' for the past\n55 days::\n\n >>> herring = hf.NWIS('01585200', 'dv', period='P55D')\n\nWe've set up our system, now we submit our request for data and get a\nresponse::\n\n >>> herring.get_data()\n \n\nCreate a dataframe from our data, and list the first five items::\n\n >>> herring.df().head()\n\n*--a table with our data appears--*\n\n +------------+--------------------------------------------------+\n | datetime | 01585200 - Mean Discharge, cubic feet per second |\n +------------+--------------------------------------------------+\n | 2017-06-01 | 0.71 |\n +------------+--------------------------------------------------+\n | 2017-06-02 | 0.64 |\n +------------+--------------------------------------------------+\n | 2017-06-03 | 0.61 |\n +------------+--------------------------------------------------+\n | 2017-06-04 | 0.58 |\n +------------+--------------------------------------------------+\n | 2017-06-05 | 1.95 |\n +------------+--------------------------------------------------+\n\nPlot the data using built-in methods from Pandas and mathplotlib::\n\n >>> herring.df().plot()\n\n*--a stream hydrograph appears--*\n\n.. image:: https://raw.githubusercontent.com/mroberge/hydrofunctions/master/_static/HerringHydrograph.png\n :alt: a stream hydrograph for Herring Run\n\nDraw an interactive map in a Jupyter Notebook:\n\n.. image:: https://raw.githubusercontent.com/mroberge/hydrofunctions/master/_static/draw_map.jpg\n :alt: a map in an interactive Jupyter Notebook.\n\nLearn more:\n\n* `More usage `_ tips\n* `Introduction to Hydrofunctions `_, a Jupyter Notebook with a quick tutorial.\n\nEasy Installation\n-----------------\n\nThe easiest way to install Hydrofunctions is by typing this from your \ncommand line:\n\n.. code-block:: console\n\n $ pip install hydrofunctions\n\n\nHydrofunctions depends upon Pandas and numerous other scientific packages\nfor Python. `Anaconda `_ \nis an easy, safe, open-source method for downloading everything and avoiding\nconflicts with other versions of Python that might be running on your\ncomputer.\n\nVisit the `Installation Page `_ \nin the Users Guide to learn how to install\nAnaconda, or if you have problems using the Easy Installation method above.\n\n\nOther Projects You Should See\n-----------------------------\n\n`Hydropy `_, a Python package that builds upon Pandas for enhanced data selection and plotting of hydrology data.\n\n`WellApplication `_ a Python package that provides functions for working with dataloggers and USGS well data.\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _Cookiecutter: https://github.com/audreyr/cookiecutter\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n\nMIT License\n\nCopyright (c) 2016, Martin Roberge and contributors\n\n\n=======\nHistory\n=======\n\n0.1.0 (2016-08-11)\n------------------\n\n* Project set up.\n\n0.1.1 (2016-08-11)\n------------------\n\n* Customized project boilerplate.\n\n0.1.2 (2016-08-26)\n------------------\n\n* Set up template for custom exceptions\n* Added get_nwis function\n\n0.1.3 (2016-09-09)\n-----------------------\n\n* Check user inputs & raise explanatory exceptions\n* Extract data from response into a dataframe.\n* Stations object for managing data.\n\n0.1.4 (2016-09-18)\n----------------------\n\n* Added tests & documentation.\n\n0.1.5 (2018-02-22)\n----------------------\n\n* Updated to support Python 3.6\n* Updated docs, added notebooks (mcr jdh)\n* Added parameterCd to allow requests for different datasets (thanks @jdhughes-usgs!)\n* Added ability to query sites by state or county (jdh)\n* Added ability to request lists of sites or counties (jdh)\n* Improved column names: now includes site id & variable description (for example, '07228000 - Mean Discharge, cubic feet per second')(jdh)\n* Added descriptive warnings to explain why queries fail (mcr)\n\n\n0.1.6 (2018-03-07)\n----------------------\n\n* Added draw_map function for help selecting sites (mcr)\n* Added ability to query sites by a bounding box (jdh)\n* Revised pandas dataframe column names to be the name composed of the provider, site id, parameter, and statistic (for example. USGS:01638500:00060:0001). (jdh)\n* Added qualifiers for each station as a column in the dataframe. (jdh)\n* Added ability extract NWIS property data from the response object (for example, siteName). (jdh)\n\n0.1.7 (2018-11-11)\n----------------------\n\n* Added a flow duration chart (mcr)\n* Added the cycleplot chart (mcr)\n* Added code coverage (mcr)\n* Improved the build scripts for TravisCI (mcr)\n* Updated to support Python 3.7\n\n", "description_content_type": "", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mroberge/hydrofunctions", "keywords": "hydrofunctions hydrology USGS stream gauge water NWIS", "license": "MIT license", "maintainer": "", "maintainer_email": "", "name": "HydroFunctions", "package_url": "https://pypi.org/project/HydroFunctions/", "platform": "", "project_url": "https://pypi.org/project/HydroFunctions/", "project_urls": { "Documentation": "https://hydrofunctions.readthedocs.io", "Homepage": "https://github.com/mroberge/hydrofunctions", "Latest": "https://github.com/mroberge/hydrofunctions/tree/develop", "Source": "https://github.com/mroberge/hydrofunctions", "Tracker": "https://github.com/mroberge/hydrofunctions/issues" }, "release_url": "https://pypi.org/project/HydroFunctions/0.1.7/", "requires_dist": [ "matplotlib", "numpy", "pandas", "requests", "IPython" ], "requires_python": "", "summary": "A suite of convenience functions for exploring water data in a Jupyter Notebook.", "version": "0.1.7" }, "last_serial": 4483846, "releases": { "0.0.0": [ { "comment_text": "", "digests": { "md5": "2c6966f53f734e33bc4599b276e04e80", "sha256": "44f10d57000efa2ba25a12a82aa37c43c76c91cf0e768dd8b0fbfa45450980ea" }, "downloads": -1, "filename": "HydroFunctions-0.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "2c6966f53f734e33bc4599b276e04e80", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 1904, "upload_time": "2016-08-11T03:41:49", "url": "https://files.pythonhosted.org/packages/09/2d/294ed3c3d00f327b2354fe22c982d9cd7d31a333e16bcd72f3231ac85a98/HydroFunctions-0.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "cf0490d3d4c8d0ebcc733385e7f54276", "sha256": "56c27e9cec7a30a9156d3f44351686d18342ca6e135588308480cba19cd64071" }, "downloads": -1, "filename": "HydroFunctions-0.0.0.zip", "has_sig": false, "md5_digest": "cf0490d3d4c8d0ebcc733385e7f54276", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 3441, "upload_time": "2016-08-11T03:41:51", "url": "https://files.pythonhosted.org/packages/9c/d5/ede4d28b346369a92dc283c448464f4f2f5c2137f9216b17269ba3177183/HydroFunctions-0.0.0.zip" } ], "0.0.1": [ { "comment_text": "", "digests": { "md5": "639aa506d2984a9e07e4b3b19d3a819e", "sha256": "5ae84dbe95c32cc56de5ad6df93eaab78facffcb5189dc4dbbc9d7dbe9ee77b6" }, "downloads": -1, "filename": "HydroFunctions-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "639aa506d2984a9e07e4b3b19d3a819e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 1895, "upload_time": "2016-08-11T18:05:56", "url": "https://files.pythonhosted.org/packages/70/e8/336736ebb1396684420de9d4070aa5020393bf2e4bcee904d0f3cf627ec3/HydroFunctions-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b174ebf7ef700cab0c286a8189ee9728", "sha256": "ac5fcc129e00bf2b776723ec3198766cb19853566344cf45595dcd0d09ccc1b9" }, "downloads": -1, "filename": "HydroFunctions-0.0.1.zip", "has_sig": false, "md5_digest": "b174ebf7ef700cab0c286a8189ee9728", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4576, "upload_time": "2016-08-11T18:06:01", "url": "https://files.pythonhosted.org/packages/aa/9d/52dca2a59e14c3b984226effe06c79c309c9c707bed9c6947f09af2a5ad1/HydroFunctions-0.0.1.zip" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "54ff4916207d374aca8523d89dc46069", "sha256": "c2c09f17798f74575ed62ca85cfc699221577af7f05f5a0f60d179c815c19ce4" }, "downloads": -1, "filename": "hydrofunctions-0.1.1-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "54ff4916207d374aca8523d89dc46069", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 4032, "upload_time": "2016-08-12T04:36:42", "url": "https://files.pythonhosted.org/packages/6d/07/89cc4acd22ca8657ce6149da0e249b9614919448b6eaa1d44bdd5bbe6dde/hydrofunctions-0.1.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "3007f4f396636a420a9dd6b072211f79", "sha256": "03a9e1d7856c5629e85216b3c6e3d1a3d0a94feeee101bec3345f48a459e6d00" }, "downloads": -1, "filename": "hydrofunctions-0.1.1.zip", "has_sig": false, "md5_digest": "3007f4f396636a420a9dd6b072211f79", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18966, "upload_time": "2016-08-12T04:36:44", "url": "https://files.pythonhosted.org/packages/3e/a7/dee7cf491060aed9cea6e84f7b664ceebde95cd8d4c8ff861f757e7ac9d1/hydrofunctions-0.1.1.zip" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "4ecc51bbab273d6c3c0d3929db2d1cc8", "sha256": "e8916a835bc80b53d50e047280458e5a6feeb369be9e6ea82e0ec9ddd951fae2" }, "downloads": -1, "filename": "hydrofunctions-0.1.2-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "4ecc51bbab273d6c3c0d3929db2d1cc8", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 10713, "upload_time": "2016-09-10T00:46:43", "url": "https://files.pythonhosted.org/packages/10/20/730565b96b9574b1fe38594bb459a0280255d753f33043c32bdc31e09ae4/hydrofunctions-0.1.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "7a08eafcd71cf250519ef4c8f146c5aa", "sha256": "7c49a24e65900039af547cf9a18d170df9161d8ec4762e0f6b0b2db7f57e6d38" }, "downloads": -1, "filename": "hydrofunctions-0.1.2.tar.gz", "has_sig": false, "md5_digest": "7a08eafcd71cf250519ef4c8f146c5aa", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16790, "upload_time": "2016-09-10T00:46:45", "url": "https://files.pythonhosted.org/packages/e0/d3/744be2274262b96dd4b156dd70af51b61747be1f9f32feb7c4cfcf610a04/hydrofunctions-0.1.2.tar.gz" } ], "0.1.4": [ { "comment_text": "", "digests": { "md5": "e3f9eac6e04f0ead94b30ef5e94ee7f5", "sha256": "d1022d904adbae04a3cff06a094afd264b9d35ff72cad390a789997be6101ae5" }, "downloads": -1, "filename": "hydrofunctions-0.1.4-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "e3f9eac6e04f0ead94b30ef5e94ee7f5", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 12804, "upload_time": "2016-09-19T03:28:07", "url": "https://files.pythonhosted.org/packages/ec/57/4689f4fe28f5e9af92f5cb3dd6dba3840ff411a37541e5096888b8f23d2f/hydrofunctions-0.1.4-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "8232530060fbf26694cb1e14ebbb1aa8", "sha256": "d9ddba5d9e39702f0929afa7d994f050b4cf0f43e766ed913b599ca7ac27b8c6" }, "downloads": -1, "filename": "hydrofunctions-0.1.4.tar.gz", "has_sig": false, "md5_digest": "8232530060fbf26694cb1e14ebbb1aa8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17994, "upload_time": "2016-09-19T03:28:09", "url": "https://files.pythonhosted.org/packages/e7/59/a6607a5f52c8ef7199bd1bc0e19f3e04a117975a18f27db2848f67ad3771/hydrofunctions-0.1.4.tar.gz" } ], "0.1.5": [ { "comment_text": "", "digests": { "md5": "b6fc433fc3251786acbb7bb301c0987b", "sha256": "11026f8dd978daf8274468bed976cbddfdf4c8067aee9a831f4864a0c2629bf5" }, "downloads": -1, "filename": "hydrofunctions-0.1.5-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "b6fc433fc3251786acbb7bb301c0987b", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 23384, "upload_time": "2018-02-23T02:16:18", "url": "https://files.pythonhosted.org/packages/7c/a3/4ca993ed0d02be8fe4b81f8fb7911bdd6e288ee8ec25f8c88ade73302a3e/hydrofunctions-0.1.5-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "6f3f961e81e4a440af38040b46de5305", "sha256": "7b0b998dd3763a737532b1f521caf8a1ab30ad88dda437a76248bce5f9981c15" }, "downloads": -1, "filename": "hydrofunctions-0.1.5.tar.gz", "has_sig": false, "md5_digest": "6f3f961e81e4a440af38040b46de5305", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 48931, "upload_time": "2018-02-23T02:16:20", "url": "https://files.pythonhosted.org/packages/f1/fe/9d395a98b6202d610199cbc59c557bbc2e3723fed16d11481c62d95b56e6/hydrofunctions-0.1.5.tar.gz" } ], "0.1.6": [ { "comment_text": "", "digests": { "md5": "efa2af1120d8d0f8ae768e26a178a697", "sha256": "ad6a2eb739ebcc5418de300bf389aeedbed5c44501f79377f48dee9d8beb2b96" }, "downloads": -1, "filename": "hydrofunctions-0.1.6-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "efa2af1120d8d0f8ae768e26a178a697", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 27424, "upload_time": "2018-03-07T19:32:25", "url": "https://files.pythonhosted.org/packages/ef/9f/4e69397f8c62bf4ab25d6330ac5bffb5a7ba2348fe0674b31d21b99c2a2f/hydrofunctions-0.1.6-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a43ef4e13dfde097c593e9aa9dd64a0f", "sha256": "95b336cb62220f6abe08e24eda2ba608607d66f5db7052aafb5812a6a723d52d" }, "downloads": -1, "filename": "hydrofunctions-0.1.6.tar.gz", "has_sig": false, "md5_digest": "a43ef4e13dfde097c593e9aa9dd64a0f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 52122, "upload_time": "2018-03-07T19:32:27", "url": "https://files.pythonhosted.org/packages/a3/44/512dc40a0d32ad69b6ebefbea3ded126c98ddc8d18b66e78024064209040/hydrofunctions-0.1.6.tar.gz" } ], "0.1.7": [ { "comment_text": "", "digests": { "md5": "8fdc762178eb546980f6c1ebeba08680", "sha256": "8f6636f23b0aa7406e72d29435ec3eb72fb9b14989ac4fa019309ef19b723c8f" }, "downloads": -1, "filename": "hydrofunctions-0.1.7-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8fdc762178eb546980f6c1ebeba08680", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 36296, "upload_time": "2018-11-14T01:18:06", "url": "https://files.pythonhosted.org/packages/8c/c5/99064d0981546ecb78071a8e0fd5114e1023e2945d2a01f88960af839017/hydrofunctions-0.1.7-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "52f5c676f181673be8eb2c8546405440", "sha256": "6d7c9eff8ee0ff4a365126649236fe5b4285a12eaff1584bd50020a7a8b4471d" }, "downloads": -1, "filename": "hydrofunctions-0.1.7.tar.gz", "has_sig": false, "md5_digest": "52f5c676f181673be8eb2c8546405440", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 774681, "upload_time": "2018-11-14T01:18:08", "url": "https://files.pythonhosted.org/packages/f8/64/4a3c8e6d7bc9d1b2d5c0aa47fad2cfe0bc48f97559ff8af779c4d998b02f/hydrofunctions-0.1.7.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "8fdc762178eb546980f6c1ebeba08680", "sha256": "8f6636f23b0aa7406e72d29435ec3eb72fb9b14989ac4fa019309ef19b723c8f" }, "downloads": -1, "filename": "hydrofunctions-0.1.7-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "8fdc762178eb546980f6c1ebeba08680", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 36296, "upload_time": "2018-11-14T01:18:06", "url": "https://files.pythonhosted.org/packages/8c/c5/99064d0981546ecb78071a8e0fd5114e1023e2945d2a01f88960af839017/hydrofunctions-0.1.7-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "52f5c676f181673be8eb2c8546405440", "sha256": "6d7c9eff8ee0ff4a365126649236fe5b4285a12eaff1584bd50020a7a8b4471d" }, "downloads": -1, "filename": "hydrofunctions-0.1.7.tar.gz", "has_sig": false, "md5_digest": "52f5c676f181673be8eb2c8546405440", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 774681, "upload_time": "2018-11-14T01:18:08", "url": "https://files.pythonhosted.org/packages/f8/64/4a3c8e6d7bc9d1b2d5c0aa47fad2cfe0bc48f97559ff8af779c4d998b02f/hydrofunctions-0.1.7.tar.gz" } ] }