{ "info": { "author": "James Rowe", "author_email": "jnrowe@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 7 - Inactive", "Environment :: Console", "Intended Audience :: Developers", "Intended Audience :: End Users/Desktop", "License :: OSI Approved", "License :: OSI Approved :: GNU General Public License (GPL)", "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)", "Natural Language :: English", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.0", "Programming Language :: Python :: 3.1", "Programming Language :: Python :: 3.2", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Topic :: Database", "Topic :: Database :: Database Engines/Servers", "Topic :: Scientific/Engineering", "Topic :: Scientific/Engineering :: GIS", "Topic :: Software Development :: Libraries :: Python Modules", "Topic :: Text Processing", "Topic :: Text Processing :: Filters", "Topic :: Utilities" ], "description": "``upoints`` - Modules for working with points on Earth\n======================================================\n\n.. warning::\n\n At this point ``upoints`` only exists to assist the users who have been using\n it for years, I *absolutely* do **not** recommend its use to new users.\n\nIntroduction\n------------\n\n``upoints`` is a collection of `GPL v3`_ licensed modules for working with\npoints on Earth, or other near spherical objects. It allows you to calculate\nthe distance and bearings between points, mangle xearth_/xplanet_ data files,\nwork with online UK trigpoint databases, NOAA_'s weather station database and\nother such location databases.\n\nPrevious versions of ``upoints`` were called ``earth_distance``, but the name\nwas changed as it no longer reflected the majority of uses the packages was\ntargeted at.\n\nRequirements\n------------\n\n``upoints``'s only strict requirements beyond the Python_ standard library are\naaargh_ and lxml_, and as such should run with Python 2.6 or newer [#]_. If\n``upoints`` doesn't work with the version of Python you have installed, drop me\na mail_ and I'll endeavour to fix it.\n\nThe modules have been tested on many UNIX-like systems, including Linux and OS\nX, but it should work fine on other systems too. The modules and scripts\ncontain a large collection of tests that can be checked with nose2_.\n\n.. [#] If you still use Python v2.5 only small changes are required, for example\n to the property definitions.\n\n.. [#] Some tests may fail due to rounding errors depending on the system the\n tests are being run on, but such instances should be obvious even to the\n casual user and some effort has been put in to reduce the likelihood of\n such failures.\n\nExample\n-------\n\nThe simplest way to show how ``upoints`` works is by example, and here goes::\n\n >>> from upoints import point\n >>> Home = point.Point(52.015, -0.221)\n >>> Telford = point.Point(52.6333, -2.5000)\n >>> print(\"%d kM, with an initial bearing of %d\u00b0\"\n ... % (Home.distance(Telford), Home.bearing(Telford)))\n 169 kM, with an initial bearing of 294\u00b0\n\nAll the class definitions, methods and independent functions contain hopefully\nuseful usage examples in the docstrings. The API documentation is built with\nSphinx_, and is available in ``doc/html/api/``.\n\nThere is some accompanying text and examples for ``point.py``, formerly\n``edist.py``, available in `geolocation and path cross`_. More examples are\navailable for ``xearth.py`` in `xearth and path cross`_. Some background and\nmore examples for ``trigpoints.py`` is online in `Trigpointing and point.py`_.\nUsage examples for ``cities.py`` is available in `Cities and cities.py`_. And\nfinally, `Pythons on a plane`_ contains information on ``weather_stations.py``.\n\nThanks\n------\n\nThe following people have submitted patches, testing and feedback:\n\n* C\u00e9dric Dufour - ``edist.py``'s CSV import, and flight plan output\n* Thomas Traber - GPX support enhancements, Points filtering, and some cool\n usage scenarios\n* Kelly Turner - Xearth_ import idea, and copious testing\n* Simon Woods - Testing\n\nAPI Stability\n-------------\n\nAPI stability isn't guaranteed across versions, although frivolous changes won't\nbe made.\n\nWhen ``upoints`` 1.0 is released the API will be frozen, and any changes which\naren't backwards compatible will force a major version bump.\n\nLimitations\n-----------\n\nThe modules assume the caller will take care of significant digits, and output\nformatting [#]_. All results are returned with whatever precision your Python\ninstall or system generates; unintuitive float representation, rounding errors,\nwarts and all.\n\nThe reasoning is simple, the caller should always know what is required and any\nheuristics added to the code would be just that -- guesses, which can and will\nbe wrong.\n\nThe ``upoints`` modules do not take flattening in to account, as in calculations\nbased in most populated areas of the earth the errors introduced by ignoring the\nearth's flattening are quite small. Future versions may change if the\nlimitation becomes an issue in real use.\n\nAlthough not really a limitation one should also be careful to use data sources\nthat are based around the same datum, and even within two data sources that use\nthe same datum you should make sure they use the same representations. It isn't\nunusual to find data sources from the USA that specify longitudes west of\nGreenwich as positive for example.\n\n.. [#] A future release may include more standard output definitions, but there\n is no intention to add \"magic\" data mangling.\n\nBugs\n----\n\nIf you find a bug don't hesitate to drop me a mail_ preferably including\na minimal testcase, or even better a patch!\n\n.. _GPL v3: http://www.gnu.org/licenses/\n.. _xearth: http://hewgill.com/xearth/original/\n.. _xplanet: http://xplanet.sourceforge.net/\n.. _Python: http://www.python.org/\n.. _geolocation and path cross: doc/geolocation_and_pathcross.html\n.. _xearth and path cross: doc/xearth_and_pathcross.html\n.. _Trigpointing and point.py: doc/trigpointing_and_point_py.html\n.. _Cities and cities.py: doc/python_cities.html\n.. _Pythons on a plane: doc/pythons_on_a_plane.html\n.. _NOAA: http://weather.noaa.gov/\n.. _mail: jnrowe@gmail.com\n.. _aaargh: https://crate.io/packages/aaargh/\n.. _lxml: http://codespeak.net/lxml/\n.. _Sphinx: http://sphinx.pocoo.org/\n.. _nose2: https://crate.io/packages/nose2/", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/JNRowe/upoints/", "keywords": "baken,cities,geonames,gis,gps,gpx,navigation,nmea,openstreetmap,trigpointing,weather,xearth", "license": "GPL-3", "maintainer": null, "maintainer_email": null, "name": "upoints", "package_url": "https://pypi.org/project/upoints/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/upoints/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/JNRowe/upoints/" }, "release_url": "https://pypi.org/project/upoints/0.12.2/", "requires_dist": null, "requires_python": null, "summary": "Modules for working with points on Earth", "version": "0.12.2" }, "last_serial": 1006900, "releases": { "0.11.0": [ { "comment_text": "", "digests": { "md5": "6cf42d129ba9456752b146341cadafbc", "sha256": "28db7cce44a6e1ac7b6b282c8da9aea2fa254c806b0565708c483004d4e4cfe9" }, "downloads": -1, "filename": "upoints-0.11.0.tar.bz2", "has_sig": true, "md5_digest": "6cf42d129ba9456752b146341cadafbc", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 200305, "upload_time": "2012-08-09T06:21:14", "url": "https://files.pythonhosted.org/packages/3e/3c/290b39298cdd201a635e7d890805cc384b62f8d6df8e2ea0f3f2c1c9b7a9/upoints-0.11.0.tar.bz2" } ], "0.12.0": [ { "comment_text": "", "digests": { "md5": "950c1a0e741d3f4d4e329a8497b4d071", "sha256": "8bf9e2d34092a2018e17db029a7272f288500b06dc94e15c28d82c2a34984410" }, "downloads": -1, "filename": "upoints-0.12.0-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "950c1a0e741d3f4d4e329a8497b4d071", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 72148, "upload_time": "2014-01-29T07:01:58", "url": "https://files.pythonhosted.org/packages/9d/8b/19ff124a17408a923f0a671b0e5e751d3ca3aac637af4ffc8fd0b7fb7d78/upoints-0.12.0-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "ecaf3b26cf381b634b216aea8548b2e5", "sha256": "c9fb07decaaa2dd5a8a0b255462ff25ed65c4e041d12ed55c092f3079002dae5" }, "downloads": -1, "filename": "upoints-0.12.0.tar.bz2", "has_sig": true, "md5_digest": "ecaf3b26cf381b634b216aea8548b2e5", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 487496, "upload_time": "2014-01-29T07:01:03", "url": "https://files.pythonhosted.org/packages/12/53/5ea6dfc568a2a71607285be7d5c8f45aa5191cde9f21231801f175594086/upoints-0.12.0.tar.bz2" }, { "comment_text": "", "digests": { "md5": "16e00b9fcc78926a72dd34c2c5ac1e9c", "sha256": "8146b17e80015007fe0feac5cf1147823f616f0324cd99e55d5fec43a27d8ab1" }, "downloads": -1, "filename": "upoints-0.12.0.tar.gz", "has_sig": true, "md5_digest": "16e00b9fcc78926a72dd34c2c5ac1e9c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 498924, "upload_time": "2014-01-29T07:01:33", "url": "https://files.pythonhosted.org/packages/03/c4/24cd5e67c09525d58d425c86b83852bdb59c9e749c182828948b97a025ed/upoints-0.12.0.tar.gz" } ], "0.12.1": [ { "comment_text": "", "digests": { "md5": "da166e2ada5bfe48062984022c2fb5ba", "sha256": "9b3ddf4c9b3f6990ed6348befc59e0aa6165cc14c573f8d7c1a09897757e0406" }, "downloads": -1, "filename": "upoints-0.12.1-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "da166e2ada5bfe48062984022c2fb5ba", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 72230, "upload_time": "2014-01-31T15:12:13", "url": "https://files.pythonhosted.org/packages/d7/e7/47f7873b28ce43655c06aaa6ea689f542a5a129d593638f664903ce51213/upoints-0.12.1-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "70c18b7abfbae5164e43c700703ef8cb", "sha256": "4f56c5c81560c2d9385d5bf166d58338e20a7e22d2a41fa22bc00c2b4192ee18" }, "downloads": -1, "filename": "upoints-0.12.1.tar.bz2", "has_sig": true, "md5_digest": "70c18b7abfbae5164e43c700703ef8cb", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 487725, "upload_time": "2014-01-31T15:11:37", "url": "https://files.pythonhosted.org/packages/a6/bb/b9a41dc407e3f07cfc40cfc828473c451047a441491aa6164f5b53b83447/upoints-0.12.1.tar.bz2" }, { "comment_text": "", "digests": { "md5": "0d75727b0bc4e446a9a16f21d958da40", "sha256": "2b23799405329c3983916aefcf08a18bd002dabe26a9f0452fd00db21aa070f3" }, "downloads": -1, "filename": "upoints-0.12.1.tar.gz", "has_sig": true, "md5_digest": "0d75727b0bc4e446a9a16f21d958da40", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 499223, "upload_time": "2014-01-31T15:12:00", "url": "https://files.pythonhosted.org/packages/ac/b7/261be7636d9356970aa14a1ecc0a49c8b4b64e30d5cc7667dcb7810c1b2e/upoints-0.12.1.tar.gz" } ], "0.12.2": [ { "comment_text": "", "digests": { "md5": "c48d9081e03f4e9b9223e08fc46b6312", "sha256": "932e826d310cb04e6177ee101b2eab040470334772753c62561b8e4a51bdd889" }, "downloads": -1, "filename": "upoints-0.12.2-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "c48d9081e03f4e9b9223e08fc46b6312", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 72234, "upload_time": "2014-02-20T21:39:22", "url": "https://files.pythonhosted.org/packages/5c/b9/f6a74ec75ef6c4f1f82f8b80268ab815278915ea4bcf56894bae2c925049/upoints-0.12.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d5e2683a10d1b1278611ed53d299524f", "sha256": "13be0d9817ec06cae29fdf8e18bb45f97eea588bef8fde769a0a1c5c3851a55c" }, "downloads": -1, "filename": "upoints-0.12.2.tar.bz2", "has_sig": true, "md5_digest": "d5e2683a10d1b1278611ed53d299524f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 488225, "upload_time": "2014-02-20T21:39:04", "url": "https://files.pythonhosted.org/packages/2c/d3/0fb4119b01a8329000e0f75b0890e68b9e64c44b253583f62f919e6d203e/upoints-0.12.2.tar.bz2" }, { "comment_text": "", "digests": { "md5": "5baeaecc30e83dead825d12ef354b745", "sha256": "0c63f6bec854e5118541aaa81b671d38f6051d8241a9c59aa13157d68674b33c" }, "downloads": -1, "filename": "upoints-0.12.2.tar.gz", "has_sig": true, "md5_digest": "5baeaecc30e83dead825d12ef354b745", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 499485, "upload_time": "2014-02-20T21:39:19", "url": "https://files.pythonhosted.org/packages/25/62/3d2930a1148bf8c08ebcedfc36d5c1f9fed2897cb6177af9ef2cb058bd4f/upoints-0.12.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c48d9081e03f4e9b9223e08fc46b6312", "sha256": "932e826d310cb04e6177ee101b2eab040470334772753c62561b8e4a51bdd889" }, "downloads": -1, "filename": "upoints-0.12.2-py2.py3-none-any.whl", "has_sig": true, "md5_digest": "c48d9081e03f4e9b9223e08fc46b6312", "packagetype": "bdist_wheel", "python_version": "2.7", "requires_python": null, "size": 72234, "upload_time": "2014-02-20T21:39:22", "url": "https://files.pythonhosted.org/packages/5c/b9/f6a74ec75ef6c4f1f82f8b80268ab815278915ea4bcf56894bae2c925049/upoints-0.12.2-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d5e2683a10d1b1278611ed53d299524f", "sha256": "13be0d9817ec06cae29fdf8e18bb45f97eea588bef8fde769a0a1c5c3851a55c" }, "downloads": -1, "filename": "upoints-0.12.2.tar.bz2", "has_sig": true, "md5_digest": "d5e2683a10d1b1278611ed53d299524f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 488225, "upload_time": "2014-02-20T21:39:04", "url": "https://files.pythonhosted.org/packages/2c/d3/0fb4119b01a8329000e0f75b0890e68b9e64c44b253583f62f919e6d203e/upoints-0.12.2.tar.bz2" }, { "comment_text": "", "digests": { "md5": "5baeaecc30e83dead825d12ef354b745", "sha256": "0c63f6bec854e5118541aaa81b671d38f6051d8241a9c59aa13157d68674b33c" }, "downloads": -1, "filename": "upoints-0.12.2.tar.gz", "has_sig": true, "md5_digest": "5baeaecc30e83dead825d12ef354b745", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 499485, "upload_time": "2014-02-20T21:39:19", "url": "https://files.pythonhosted.org/packages/25/62/3d2930a1148bf8c08ebcedfc36d5c1f9fed2897cb6177af9ef2cb058bd4f/upoints-0.12.2.tar.gz" } ] }