{ "info": { "author": "Neil Freeman", "author_email": "contact@fakeisthenewreal.org", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: GNU General Public License v3 (GPLv3)", "Natural Language :: English", "Operating System :: OS Independent", "Operating System :: Unix", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: Implementation :: PyPy" ], "description": "tidetable\n=========\n\nTidetable is a Python module for downloading annual tide prediction\ntables from the `NOAA Tides &\nCurrents `__ site.\n\nInstall with ``pip install tidetable``.\n\nBasics\n------\n\nFirst, get the Station ID for your tide station from the `NOAA Tides &\nCurrents\nsite `__.\n\nThen, use the ``get`` method to download the table. This returns a\n``TideTable`` object, which is just a ``list`` with a few additional\nmetadata parameters.\n\nIn this example, we use a tide station in Maine:\n\n.. code:: python\n\n >>> import tidetable\n >>> table = tidetable.get(8416092)\n >>> table\n tidetable.TideTable(stationid=8416092)\n >>> table[0]\n {'pred_cm': 149.0, 'datetime': datetime.datetime(2014, 12, 31, 3, 44), 'pred_ft': 4.9, 'high_low': 'H'}\n\nThe ``TideTable`` object's metadata includes some location data,\ninformation about the parent tide station, and error intervals:\n\n.. code:: python\n\n >>> table.stationname, table.state\n ('Monhegan Island', 'ME')\n >>> table.datum\n 'MLLW'\n >>> table.referencetostationid\n '8418150'\n >>> table.timeoffsetlow, table.timeoffsethigh\n ('-9', '-13')\n\nTime frames\n~~~~~~~~~~~\n\nBy default, the NOAA returns the tide prediction table for the current\nyear. To get years in the recent past or future, use the ``year``\nkeyword argument. It seems that roughly five years in the past and two\nyears in the future are available. There isn't a way to get smaller time\nranges of predictions than a full year.\n\n.. code:: python\n\n >>> import tidetable\n >>> table = tidetable.get(8416092, year=2016)\n >>> table\n tidetable.TideTable(stationid=8416092)\n >>> table[4]['datetime']\n datetime.datetime(2016, 1, 1, 3, 39)\n\n(Note that the first few rows returned may be for the previous year.)\n\nWriting\n~~~~~~~\n\nThe ``TideTable`` object has a write\\_csv method. It accepts either a\nfile name or any file-like object.\n\n.. code:: python\n\n import tidetable\n table = tidetable.get(8416092)\n table.write_csv('tide_table.csv')\n\nTime zones\n~~~~~~~~~~\n\nAs you can see, ``TideTable`` is a list of ``dict``\\ s, each of which\nhas a ``datetime``, a prediction in feet and cm, and a high-or-low flag.\nThe predictions are relative to the ``datum``, which in this case is\nMLLW, or the mean lower low water level. Note that MLLW is different\nfrom sea level.\n\nBy default, the ``datetime`` is in the local time, which could be\nstandard or daylight savings time. Use the ``time_zone`` keyword\nargument to fetch times in either GMT or the local standard time zone.\nTideTable always returns naive ``datetime`` objects.\n\nUse these constants for specifying the time zone: ``tidetable.GMT``,\n``tidetable.LOCAL_STANDARD_TIME``, ``tidetable.LOCAL_TIME``.\n\n.. code:: python\n\n >>> import tidetable\n >>> table = tidetable.get(8416092, time_zone=tidetable.GMT)\n >>> table[0]['datetime']\n datetime.datetime(2014, 12, 31, 0, 15)\n\n(Note the difference from the datetime in the first example, which is in\nEastern Standard Time)", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/fitnr/tidetable", "keywords": "noaa", "license": "GPL-3.0", "maintainer": "", "maintainer_email": "", "name": "tidetable", "package_url": "https://pypi.org/project/tidetable/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/tidetable/", "project_urls": { "Homepage": "https://github.com/fitnr/tidetable" }, "release_url": "https://pypi.org/project/tidetable/0.1.2/", "requires_dist": [ "requests" ], "requires_python": "", "summary": "Thin API for NOAA tide tables", "version": "0.1.2" }, "last_serial": 1845824, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "e6c805d62c8248f021d466e4c9354304", "sha256": "10a29c25e2e4246679be367966aa5e3bd6f200d55cb220f79c21f07792fbec0b" }, "downloads": -1, "filename": "tidetable-0.1.0-py2-none-any.whl", "has_sig": false, "md5_digest": "e6c805d62c8248f021d466e4c9354304", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6768, "upload_time": "2015-12-03T18:06:12", "url": "https://files.pythonhosted.org/packages/05/aa/207282e3293035ebb730e5571772d47b7711ebe7ea2d103e7d4fdf6b2e6d/tidetable-0.1.0-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "fb2bf1f62d5ce13a956ec138a16ce98e", "sha256": "725f03fd847869dadc51095964ea8113d64a6e39ffec33f50917dafd75dd6834" }, "downloads": -1, "filename": "tidetable-0.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "fb2bf1f62d5ce13a956ec138a16ce98e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6770, "upload_time": "2015-12-03T18:06:27", "url": "https://files.pythonhosted.org/packages/6a/85/a3762407256744bc71da57b43e5778222eb0a7696e3fc30c12caa7c9a010/tidetable-0.1.0-py3-none-any.whl" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "f0b12c03d82a5713df82559e9d20927c", "sha256": "6936c1df9bcef9c8caab6fc3d921faecdd2460d6f699a91b83f308ba7e4fadf4" }, "downloads": -1, "filename": "tidetable-0.1.1-py2-none-any.whl", "has_sig": false, "md5_digest": "f0b12c03d82a5713df82559e9d20927c", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 6696, "upload_time": "2015-12-03T22:16:40", "url": "https://files.pythonhosted.org/packages/89/05/a63e16ae1ee9b29b430daaa292e3a97235a87b01e72dae312ae715107d76/tidetable-0.1.1-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "129ca905237b6565df8353ec5da89939", "sha256": "dbbeac466fea409e77cbaea09d86282d6baad36ffb9523a03cef5e58fb35bee3" }, "downloads": -1, "filename": "tidetable-0.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "129ca905237b6565df8353ec5da89939", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6699, "upload_time": "2015-12-03T22:16:47", "url": "https://files.pythonhosted.org/packages/e2/f9/13fa7aceda2eaecfd99b232cbf51cf415285e7a785862bba6b6077afd492/tidetable-0.1.1-py3-none-any.whl" } ], "0.1.2": [ { "comment_text": "", "digests": { "md5": "6c117901265e3227ed72e1398da90eaa", "sha256": "029e682ee434d77041bd3caf2db4c41ee1f279755be709b40949ef8805de1c2d" }, "downloads": -1, "filename": "tidetable-0.1.2-py2-none-any.whl", "has_sig": false, "md5_digest": "6c117901265e3227ed72e1398da90eaa", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 7431, "upload_time": "2015-12-03T22:40:20", "url": "https://files.pythonhosted.org/packages/46/ba/05b1ec3afcf5cd70969f787c51c34d2a75258e2521566dd90307a5015e6c/tidetable-0.1.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a3d660f23480e1cd787e569a0a7a130a", "sha256": "57a45c2978dd9a7e843a09998dca067f24dee137ec4dcc2d170bdd057bfe914d" }, "downloads": -1, "filename": "tidetable-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "a3d660f23480e1cd787e569a0a7a130a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7432, "upload_time": "2015-12-03T22:40:25", "url": "https://files.pythonhosted.org/packages/a7/f1/cd4e97208fcb1a81c1193f685925490e074c8459cda4483c7861149a5a02/tidetable-0.1.2-py3-none-any.whl" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "6c117901265e3227ed72e1398da90eaa", "sha256": "029e682ee434d77041bd3caf2db4c41ee1f279755be709b40949ef8805de1c2d" }, "downloads": -1, "filename": "tidetable-0.1.2-py2-none-any.whl", "has_sig": false, "md5_digest": "6c117901265e3227ed72e1398da90eaa", "packagetype": "bdist_wheel", "python_version": "py2", "requires_python": null, "size": 7431, "upload_time": "2015-12-03T22:40:20", "url": "https://files.pythonhosted.org/packages/46/ba/05b1ec3afcf5cd70969f787c51c34d2a75258e2521566dd90307a5015e6c/tidetable-0.1.2-py2-none-any.whl" }, { "comment_text": "", "digests": { "md5": "a3d660f23480e1cd787e569a0a7a130a", "sha256": "57a45c2978dd9a7e843a09998dca067f24dee137ec4dcc2d170bdd057bfe914d" }, "downloads": -1, "filename": "tidetable-0.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "a3d660f23480e1cd787e569a0a7a130a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 7432, "upload_time": "2015-12-03T22:40:25", "url": "https://files.pythonhosted.org/packages/a7/f1/cd4e97208fcb1a81c1193f685925490e074c8459cda4483c7861149a5a02/tidetable-0.1.2-py3-none-any.whl" } ] }