{ "info": { "author": "Markus Juenemann", "author_email": "markus@juenemann.net", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Natural Language :: English", "Operating System :: Unix", "Programming Language :: C", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.6", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: Software Development :: Libraries" ], "description": "**************\npython-gpsdshm\n**************\n\nOverview\n========\n\n*python-gpsdshm* provides a read-only(!) Python interface to `gpsd`_'s shared memory. It provides\na single class ``Shm`` that exposes the fields of the shared memory structure as attributes. The\n*python-gpsdshm* API is (loosely) modelled on gpsd version 3.16 (API 6.1). gpsd releases earlier\nthan 3.0 are not supported.\n\n*python-gpsdshm* is implemented using Swig_ and requires the `gpsd` header files for compilation.\n\nMany Linux distributions ship the gpsd package **without** shared memory support.\nSee `Compiling gpsd with shared memory support`_ for details how to build gpsd\nwith shared memory support.\n\n.. _`gpsd`: http://www.catb.org/gpsd/\n.. _Swig: http://www.swig.org/Doc1.3/Python.html\n\nExample\n=======\n\nThe example below shows all attributes and typical values (of a stationary GPS, placed about one metre inside a window).\n\n.. code-block:: python\n\n >>> import gpsdshm\n >>> gpsd_shm = gpsdshm.Shm()\n >>> gpsd_shm.set\n TODO: \n >>> gpsd_shm.online # True if GPS is online\n gpsd_shm.online\n TODO: Out[6]: 1454057376.6934643\n >>> gpsd_shm.status # Do we have a fix (True/False)?\n gpsd_shm.status\n TODO Out[7]: 1\n >>> gpsd_shm.skyview_time # Skyview timestamp\n >>> gpsd_shm.satellites_visible # Number of satellites in view\n TODO: nan\n >>> gpsd_shm.fix.time # Time of update\n 1454057448.0\n >>> gpsd_shm.fix.mode # Mode of fix (0=not seen, 1=no fix, 2=2D, 3=3D)\n 3\n >>> gpsd_shm.fix.ept # Expected time uncertainty\n 0.005\n >>> gpsd_shm.fix.latitude # Latitude in degrees (valid if mode >= 2)\n -37.75859333333334\n >>> gpsd_shm.fix.epy # Latitude position uncertainty, meters\n 14.853882022256698\n >>> gpsd_shm.fix.longitude # Longitude in degrees (valid if mode >= 2)\n 144.99911\n >>> gpsd_shm.fix.epx # Longitude position uncertainty, meters \n 10.040781879264545\n >>> gpsd_shm.fix.alitude # Altitude in meters (valid if mode == 3)\n 68.2\n >>> gpsd_shm.fix.epv # Vertical position uncertainty, meters\n 19.55\n >>> gpsd_shm.fix.track # Course made good (relative to true north)\n 44.45\n >>> gpsd_shm.fix.epd # Track uncertainty, degrees\n nan\n >>> gpsd_shm.fix.speed # Speed over ground, meters/sec\n 0.3446777748\n >>> gpsd_shm.fix.eps # Speed uncertainty, meters/sec\n 29.707764044513397\n >>> gpsd_shm.fix.climb # Vertical speed, meters/sec \n 0.0\n >>> gpsd_shm.fix.epc # Vertical speed uncertainty\n nan\n >>> gpsd_shm.dop.xdop\n 0.6693854586176363\n >>> gpsd_shm.dop.ydop\n 0.9902588014837799\n >>> gpsd_shm.dop.pdop\n 1.17\n >>> gpsd_shm.dop.hdop\n 0.99\n >>> gpsd_shm.dop.vdop\n 0.82\n >>> gpsd_shm.dop.tdop\n 1.2548625723457216\n >>> gpsd_shm.dop.gdop\n 2.4342743978108503\n\nInformation about satellites is contained in the ``satellites`` list.\n \n.. code-block:: python\n \n >>> gpsd_shm.satellites[0].ss # Signal-to-noise ratio (dB)\n 16.0\n >>> gpsd_shm.satellites[0].used # Used in solution?\n False\n >>> gpsd_shm.satellites[0].prn # PRNs of satellite\n 6\n >>> gpsd_shm.satellites[0].elevation # Elevation of satellite, degrees\n 56\n >>> gpsd_shm.satellites[0].azimuth # Azimuth, degrees\n 59\n\n\nCompiling gpsd with shared memory support\n=========================================\n\n.. code-block:: console\n\n $ git clone git://git.sv.gnu.org/gpsd.git # git clone http://git.savannah.gnu.org/r/gpsd.git\n $ cd gpsd\n $ git tag\n $ git checkout release-3.16\n $ scons prefix=/usr/local shm_export=yes\n $ sudo scons install\n \nThen run start gpsd and check whether the shared segment has been created. \n\n.. code-block:: console\n\n $ sudo /usr/local/sbin/gpsd -n /dev/ttyAMA0\n $ ipcs -m | grep 0x47505344\n ------ Shared Memory Segments --------\n key shmid owner perms bytes nattch status \n 0x47505344 163844 root 666 31616 1\n\n\n\n\nHistory\n=======\n\n0.1.0 (04-Feb-2016)\n---------------------\n\n* Initial version", "description_content_type": null, "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/mjuenema/python-gpsdshm", "keywords": "gpsd,shared memory", "license": "BSD License", "maintainer": "", "maintainer_email": "", "name": "gpsdshm", "package_url": "https://pypi.org/project/gpsdshm/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/gpsdshm/", "project_urls": { "Homepage": "https://github.com/mjuenema/python-gpsdshm" }, "release_url": "https://pypi.org/project/gpsdshm/0.1.1/", "requires_dist": null, "requires_python": "", "summary": "Python interface to gpsd shared memory", "version": "0.1.1" }, "last_serial": 1943476, "releases": { "0.1.0": [ { "comment_text": "", "digests": { "md5": "4c51db13438b6bbec77df6b2e10decb2", "sha256": "b1d4bd1d933f7684da2674d7ae40ae0c16b3690f57b5520fc610d175e6a9a383" }, "downloads": -1, "filename": "gpsdshm-0.1.0.tar.gz", "has_sig": false, "md5_digest": "4c51db13438b6bbec77df6b2e10decb2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 50909, "upload_time": "2016-02-06T20:28:30", "url": "https://files.pythonhosted.org/packages/32/76/76c7c6056bb373304876f525d2994341fcba437fcb1608cf9978eaea81c3/gpsdshm-0.1.0.tar.gz" } ], "0.1.1": [ { "comment_text": "", "digests": { "md5": "c0a37663f834c38b6a9a493d134b0662", "sha256": "8efa9ff0936d66b872dbfbc3f13f6fda5f236a95b3856e4db7bf5d94c5e27050" }, "downloads": -1, "filename": "gpsdshm-0.1.1.tar.gz", "has_sig": false, "md5_digest": "c0a37663f834c38b6a9a493d134b0662", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 50824, "upload_time": "2016-02-06T20:39:59", "url": "https://files.pythonhosted.org/packages/3b/fa/df1b2e54a5ad1630c285fbf1a079badc0e1ef7bb35213f9715f851044f5d/gpsdshm-0.1.1.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "c0a37663f834c38b6a9a493d134b0662", "sha256": "8efa9ff0936d66b872dbfbc3f13f6fda5f236a95b3856e4db7bf5d94c5e27050" }, "downloads": -1, "filename": "gpsdshm-0.1.1.tar.gz", "has_sig": false, "md5_digest": "c0a37663f834c38b6a9a493d134b0662", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 50824, "upload_time": "2016-02-06T20:39:59", "url": "https://files.pythonhosted.org/packages/3b/fa/df1b2e54a5ad1630c285fbf1a079badc0e1ef7bb35213f9715f851044f5d/gpsdshm-0.1.1.tar.gz" } ] }