{ "info": { "author": "Kyle Wilcox", "author_email": "kyle@axiomdatascience.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "Intended Audience :: Science/Research", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Operating System :: POSIX :: Linux", "Programming Language :: Python", "Topic :: Scientific/Engineering" ], "description": "Pyoos - A Python library for collecting Met/Ocean observations\n==============================================================\n\n.. image:: https://travis-ci.org/ioos/pyoos.svg?branch=master\n :target: https://travis-ci.org/ioos/pyoos\n :alt: Build_Status\n\n\n*Note: Pyoos is very much a work in progress and should considered\nexperimental until a 1.0 release is made!*\n\nPyoos attempts to fill the need for a high level data collection library\nfor met/ocean data publically available through many different websites\nand webservices.\n\nPyoos will collect and parse the following data services into the\n`Paegan `__\nDiscrete Geometry CDM:\n\n- IOOS SWE SOS 1.0 Services\n- ex. `NcSOS `__ instance:\n `sos.maracoos.org/stable/sos/wflow700-agg.ncml `__\n- ex. `IOOS 52N `__ instance:\n `ioossos.axiomalaska.com/52n-sos-ioos-stable `__\n- NERRS Observations - SOAP\n- NDBC Observations - SOS\n- CO-OPS Observations - SOS\n- STORET Water Quality - WqxOutbound via REST (waterqualitydata.us)\n- USGS NWIS Water Quality - WqxOutbound via REST (waterqualitydata.us)\n- USGS Instantaneous Values - WaterML via REST\n- NWS AWC Observations - XML via REST (http://www.aviationweather.gov)\n- HADS (http://www.nws.noaa.gov/oh/hads/ - limited to 7 day rolling\n window of data)\n\nCommon Interface\n----------------\n\nFiltering data\n~~~~~~~~~~~~~~\n\nGeo\n^^^\n\nFilter by bbox\n''''''''''''''\n\n.. code:: python\n\n # (minx, miny, maxx, maxy)\n collector.filter(bbox=(-74, 30, -70, 38))\n\nTime\n^^^^\n\nFilter from a datetime (the 'start' parameter)\n''''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: python\n\n from dateime import dateime, timedelta\n collector.filter(start=datetime.utcnow() - timedelta(hours=1))\n\nFilter until a datetime (the 'end' parameter)\n'''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: python\n\n from dateime import dateime\n collector.filter(end=datetime.utcnow())\n\nFilter a datetime range (both 'start' and 'end' parameters)\n'''''''''''''''''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: python\n\n from dateime import dateime, timedelta\n collector.filter(start=datetime.utcnow - timedelta(hours=24), end=datetime.utcnow())\n\nFeature(s)\n^^^^^^^^^^\n\nIt is highly dependent on the data provider how they identify unique\nfeatures/stations/objects.\nPyoos does its best job to figure out what you are passing in. For\nexample,\nyou may pass WMO ID's to the NDBC collector and Pyoos will request the\ncorrect complete URN to the NDBC SOS.\n\nRetrieve a list of unique features available to filter\n''''''''''''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: python\n\n collector.list_features()\n\nFilter by unique feature\n''''''''''''''''''''''''\n\n.. code:: python\n\n # Any iterable of strings\n collector.filter(features=[\"21KY-BSW004\"])\n\nVariable(s)\n^^^^^^^^^^^\n\nPyoos does its best job to format any string into the correct format\nfor the actual request. For example,\nyou may pass typical standard\\_name string from CF-1.6 to the NDBC\ncollector and Pyoos will turn it into a complete MMI URI.\n\nRetreive a list of unique variables available to filter\n'''''''''''''''''''''''''''''''''''''''''''''''''''''''\n\n.. code:: python\n\n collector.list_variables()\n\nFilter by variable name\n'''''''''''''''''''''''\n\n.. code:: python\n\n # Any iterable of strings\n collector.filter(variables=[\"sea_water_temperature\"])\n\nClear active filters\n^^^^^^^^^^^^^^^^^^^^\n\n.. code:: python\n\n collector.clear()\n\nFilter Chaining\n---------------\n\nYou may chain many ``filter`` calls together (it returns a collector\nobject)\n\n.. code:: python\n\n collection.filter(bbox=(-74, 30, -70, 38)).filter(end=datetime.utcnow())\n\nYou may also combine many filter types into one call to ``filter``\n\n.. code:: python\n\n collection.filter(bbox=(-74, 30, -70, 38), end=datetime.utcnow())\n\nGet Data\n--------\n\nAs Paegan CDM objects\n~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n collector.collect()\n\nAs raw response from provider\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n collector.raw()\n\nSpecific functionality\n----------------------\n\nEach collector may implement a set of functions specific to that\ncollection. Please see the Wiki for an explanation of this type of\nfunctionality.\n\nSetup\n-----\n\nYou are using ``virtualenv``, right?\n\n#. Install\n `virtualenv-burrito `__\n#. Create virtualenv named \"pyoos-dev\":\n ``mkvirtualenv -p your_python_binary pyoos-dev``\n#. Start using your new virtualenv: ``workon pyoos-dev``\n\nInstallation\n------------\n\nPyoos requires python 2.7.x and is available on PyPI.\n\nThe best way to install Pyoos is through pip:\n\n.. code:: bash\n\n pip install pyoos\n\nPyoos requires the following python libraries which will be downloaded\nand installed through ``pip``:\n\n- Paegan>=0.9.9\n- numpy>=1.7.0\n- scipy\n- netCDF4>=1.0.2\n- Shapely>=1.2.15\n- pytz\n- python-dateutil>=1.5\n- OWSLib (install from git with\n ``pip install git+http://github.com/geopython/OWSLib.git``)\n- requests\n- Fiona==0.16.1\n- beautifulsoup4==4.2.1\n- lxml>=3.2.0\n\nIf your NetCDF4 and HDF5 libraries are in non-typical locations, you\nwill need to pass the locations to the ``pip`` command:\n\n.. code:: bash\n\n NETCDF4_DIR=path HDF5_DIR=path pip install pyoos\n\nThere seems to be a problem installing numpy through ``pip`` dependency\nchains so you may need to install numpy before doing any of the above:\n\n.. code:: bash\n\n pip install numpy==1.7.0\n\nRoadmap\n-------\n\n- Development of a standardized Metadata concept, possibly through\n SensorML and/or ISO 19115-2\n\nUse Cases\n---------\n\nSubmit a PR with your use case!\n\nTroubleshooting\n---------------\n\nThere is a Google Groups mailing list for pyoos:\nhttps://groups.google.com/forum/#!forum/pyoos\n\nIf you are having trouble getting any of the pyoos functionality to\nwork, try running the tests:\n\n.. code:: bash\n\n git clone git@github.com:asascience-open/pyoos.git\n cd pyoos\n python setup.py test\n\nContributors\n------------\n\n- Kyle Wilcox kyle@axiomdatascience.com\n- Sean Cowan scowan@asascience.com\n- Alex Crosby acrosby@asascience.com\n- Dave Foster dave@axiomdatascience.com\n- Filipe Pires Alvarenga Fernandes ocefpaf@gmail.com\n\nCopyright and licence\n---------------------\n\nCopyright (C) 2012-2016 RPS ASA\n\nThis file is part of Pyoos.\n\nPyoos is free software: you can redistribute it and/or modify it under\nthe terms of the GNU Lesser General Public License as published by the\nFree Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nPyoos is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the\nGNU Lesser General Public License for more details.\n\nYou should have received a copy of the GNU Lesser General Public\nLicense\nalong with Pyoos. If not, see http://www.gnu.org/licenses/.\n", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/ioos/pyoos.git", "keywords": "", "license": "GPLv3", "maintainer": "", "maintainer_email": "", "name": "pyoos", "package_url": "https://pypi.org/project/pyoos/", "platform": "", "project_url": "https://pypi.org/project/pyoos/", "project_urls": { "Homepage": "https://github.com/ioos/pyoos.git" }, "release_url": "https://pypi.org/project/pyoos/0.8.4/", "requires_dist": null, "requires_python": "", "summary": "A Python library for collecting Met/Ocean observations", "version": "0.8.4" }, "last_serial": 2867932, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "9649306efc3f1db9314499df71bbf556", "sha256": "b2d8873b64109a3e0613778d72745d6cae743b5940e76adabe007457f088eee3" }, "downloads": -1, "filename": "pyoos-0.2.tar.gz", "has_sig": false, "md5_digest": "9649306efc3f1db9314499df71bbf556", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11749, "upload_time": "2013-01-09T20:05:46", "url": "https://files.pythonhosted.org/packages/92/b5/52c0a33dd8e3c9a5e36e18d3207366639a2a089b3408e624e3c62360d647/pyoos-0.2.tar.gz" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "c349ea69dedefe4a72cd31989b6922e8", "sha256": "65e15d0478e3440410100603cb7538a78c135147c07c0653e03115f6a8e67bf6" }, "downloads": -1, "filename": "pyoos-0.3.tar.gz", "has_sig": false, "md5_digest": "c349ea69dedefe4a72cd31989b6922e8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 30451, "upload_time": "2013-05-21T19:34:37", "url": "https://files.pythonhosted.org/packages/dc/c1/8d8c098bc8fd1ddf2b0041e96fbddbc8cca798f838d2554ca0d013800d98/pyoos-0.3.tar.gz" } ], "0.4": [ { "comment_text": "", "digests": { "md5": "ed6663b9fccbdc873923383f8e436670", "sha256": "10f3533ed50963ecd17df7ad92ca329b1af30838e6078fc78d41566f4e5a92fb" }, "downloads": -1, "filename": "pyoos-0.4.tar.gz", "has_sig": false, "md5_digest": "ed6663b9fccbdc873923383f8e436670", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 35713, "upload_time": "2013-06-04T14:16:28", "url": "https://files.pythonhosted.org/packages/85/a6/df07eeb1b1d3fea2be15a1a73bf17bf4a0827b792aad049f06a9d516e791/pyoos-0.4.tar.gz" } ], "0.5": [ { "comment_text": "", "digests": { "md5": "6f0bf6c66183447a86728ab853ab4111", "sha256": "59ce6bfb062321d25f3ec06aac75d9bff809b0e59ea5c2d8ce4d15b76fc1c5aa" }, "downloads": -1, "filename": "pyoos-0.5.tar.gz", "has_sig": false, "md5_digest": "6f0bf6c66183447a86728ab853ab4111", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 32121, "upload_time": "2013-10-02T17:59:37", "url": "https://files.pythonhosted.org/packages/6e/a8/cbe6cb81eec41150aefd04bef637081bc8d9a604f792a07cf754bb7925eb/pyoos-0.5.tar.gz" } ], "0.6.0": [ { "comment_text": "", "digests": { "md5": "e62f7d990a5fe3ff453c519ca6a748c2", "sha256": "0399309360218cbd4dfe1227da0fc5bf761cedf8d847268eae37d949b1d0f90f" }, "downloads": -1, "filename": "pyoos-0.6.0.tar.gz", "has_sig": false, "md5_digest": "e62f7d990a5fe3ff453c519ca6a748c2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38614, "upload_time": "2014-02-20T18:51:52", "url": "https://files.pythonhosted.org/packages/24/06/f0d683a579c7b4c88090ed8c68467d318429b85912f1b20b759322e13612/pyoos-0.6.0.tar.gz" } ], "0.6.1": [ { "comment_text": "", "digests": { "md5": "ba00fd88e7935f5a375774d9bc9fd284", "sha256": "93b27bf6d63a9acaf4284639d8ece1276b8ed6c3a3504030d25555cff32f94a9" }, "downloads": -1, "filename": "pyoos-0.6.1.tar.gz", "has_sig": false, "md5_digest": "ba00fd88e7935f5a375774d9bc9fd284", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39073, "upload_time": "2014-04-09T16:32:31", "url": "https://files.pythonhosted.org/packages/8f/3a/dd3e58c82bb2510192038c679c3319bd905eaa824c8f2bc70ca3bc7fc216/pyoos-0.6.1.tar.gz" } ], "0.6.2": [ { "comment_text": "", "digests": { "md5": "adf54847bd775158a071e35236e14ce4", "sha256": "f8ab5479eac6cdaa1eae5cfeca8a5d58abff6a6eeb14ad59ee0981729f34d9a1" }, "downloads": -1, "filename": "pyoos-0.6.2.tar.gz", "has_sig": false, "md5_digest": "adf54847bd775158a071e35236e14ce4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38898, "upload_time": "2014-08-01T20:50:08", "url": "https://files.pythonhosted.org/packages/d7/be/00f2ac9e544b3fa8841b31f050aee3df955c75184797a0a8996cf95c2d47/pyoos-0.6.2.tar.gz" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "bb79d03a57542bfa838c158765b949a8", "sha256": "7adf5b8178892f90803239bd964eb068bb307881c9f0a5c49c280635a667beb2" }, "downloads": -1, "filename": "pyoos-0.7.0.tar.gz", "has_sig": false, "md5_digest": "bb79d03a57542bfa838c158765b949a8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 40313, "upload_time": "2016-01-05T23:00:25", "url": "https://files.pythonhosted.org/packages/63/5e/019549293bafea834b2ad646810a3311b6625a7703f785cbef7fa148e51c/pyoos-0.7.0.tar.gz" } ], "0.8.0": [ { "comment_text": "", "digests": { "md5": "aa5025c171ca339cea9404d302695e50", "sha256": "9d6cf65bfff3b78233eb313eee7a132e54be1941b83c890bcd8d8a4b68ee106f" }, "downloads": -1, "filename": "pyoos-0.8.0.tar.gz", "has_sig": false, "md5_digest": "aa5025c171ca339cea9404d302695e50", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41263, "upload_time": "2016-08-24T17:36:27", "url": "https://files.pythonhosted.org/packages/67/8f/3178c20c9792cff2b340b41a284fe0a8397273d5e5d65696aa90bb82f7dc/pyoos-0.8.0.tar.gz" } ], "0.8.1": [ { "comment_text": "", "digests": { "md5": "04261ab8ba40114850dfc370d99fc21f", "sha256": "ae376f2db207be3e712cb27bcb1d9cdb4ffd64420eaa4b1b7eba4d96210d1d6d" }, "downloads": -1, "filename": "pyoos-0.8.1.tar.gz", "has_sig": false, "md5_digest": "04261ab8ba40114850dfc370d99fc21f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41310, "upload_time": "2016-08-24T18:47:44", "url": "https://files.pythonhosted.org/packages/88/0c/bbacf9bd9dc97db01758b40a87985b260f2e958d670c212a3beba06e4b86/pyoos-0.8.1.tar.gz" } ], "0.8.2": [ { "comment_text": "", "digests": { "md5": "5495ad3c886ad72f07796a1f4a2cc625", "sha256": "411700e61c1d63ecfc675508ddc79bdeb1e61b307211f2f59c85443270c6365f" }, "downloads": -1, "filename": "pyoos-0.8.2.tar.gz", "has_sig": false, "md5_digest": "5495ad3c886ad72f07796a1f4a2cc625", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41373, "upload_time": "2016-08-26T18:25:08", "url": "https://files.pythonhosted.org/packages/c7/4c/6c76eeb9feeb1775da11ee0e6d27641db9dac5751e423b9ae01884083490/pyoos-0.8.2.tar.gz" } ], "0.8.3": [ { "comment_text": "", "digests": { "md5": "7adcba64ad4b74d1050fe4d2868bf566", "sha256": "b992d51dd71630cf58119406ff24b96b53bcdd1b3555c8955917d89c718c8513" }, "downloads": -1, "filename": "pyoos-0.8.3.tar.gz", "has_sig": false, "md5_digest": "7adcba64ad4b74d1050fe4d2868bf566", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 41537, "upload_time": "2016-12-13T19:01:13", "url": "https://files.pythonhosted.org/packages/12/d0/7ebccbbf5fe4a6d3c532ce221556864b1bf4d7d329ba3a811eba6e5c6304/pyoos-0.8.3.tar.gz" } ], "0.8.4": [ { "comment_text": "", "digests": { "md5": "0bda9327ee90e835e8ebc54ad4d02a0c", "sha256": "c808f31b0a58232e8e20c2e47c9d83112a98fc9e3f8d521639b1f3b6e0f2f28a" }, "downloads": -1, "filename": "pyoos-0.8.4.tar.gz", "has_sig": false, "md5_digest": "0bda9327ee90e835e8ebc54ad4d02a0c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43342, "upload_time": "2017-03-30T17:15:09", "url": "https://files.pythonhosted.org/packages/06/ab/92a8b4763e4274c942aa669cbca5602f0d125ecca29479cbcca45a69bfae/pyoos-0.8.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0bda9327ee90e835e8ebc54ad4d02a0c", "sha256": "c808f31b0a58232e8e20c2e47c9d83112a98fc9e3f8d521639b1f3b6e0f2f28a" }, "downloads": -1, "filename": "pyoos-0.8.4.tar.gz", "has_sig": false, "md5_digest": "0bda9327ee90e835e8ebc54ad4d02a0c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 43342, "upload_time": "2017-03-30T17:15:09", "url": "https://files.pythonhosted.org/packages/06/ab/92a8b4763e4274c942aa669cbca5602f0d125ecca29479cbcca45a69bfae/pyoos-0.8.4.tar.gz" } ] }