Metadata-Version: 1.1
Name: ggps
Version: 0.1.7
Summary: ggps is a python library for parsing Garmin gpx and tcx files
Home-page: https://github.com/cjoakim/ggps
Author: Christopher Joakim
Author-email: christopher.joakim@gmail.com
License: MIT
Description: ggps - gps file utilities for garmin connect and garmin devices
        ===============================================================
        
        Features
        --------
        
        - Parse gpx and tcx files downloaded from Garmin Connect
        - The GPX parsed Trackpoint data includes additional/augmented values, including as "seq" and "elapsedtime".
        - The TCX parsed Trackpoint data additionally includes additional/augmented values, such as "altitudefeet", "distancemiles", "distancekilometers", and "runcadencex2".
        
        
        Quick start
        -----------
        
        Installation:
        
        .. code-block:: console
        
            $ pip install ggps
        
        Use:
        
        .. code-block:: pycon
        
            >>> import ggps
        
            >>> import ggps
            >>> infile = 'data/new_river_50k.gpx'
            >>> handler = ggps.GpxHandler.parse(infile)
            >>> trackpoints = handler.trackpoints
            >>> len(trackpoints)
            2636
            >>> print(trackpoints[-1].values)
            {
              "elapsedtime": "05:42:18",
              "latitudedegrees": "36.715144934132695",
              "longitudedegrees": "-80.9767899569124",
              "seq": "2636",
              "time": "2015-10-17T17:42:30.000Z",
              "type": "Trackpoint"
            }
        
            >>> infile = 'data/twin_cities_marathon.tcx'
            >>> handler = ggps.TcxHandler.parse(infile)
            >>> trackpoints = handler.trackpoints
            >>> len(trackpoints)
            2256
            >>> print(trackpoints[-1].values)
            {
              "altitudefeet": "864.82941635",
              "altitudemeters": "263.6000061035156",
              "distancekilometers": "42.6354492187",
              "distancemeters": "42635.44921875",
              "distancemiles": "26.4924399126",
              "elapsedtime": "04:14:24",
              "heartratebpm": "161",
              "latitudedegrees": "44.95180849917233",
              "longitudedegrees": "-93.10493202880025",
              "runcadence": "77",
              "runcadencex2": "154",
              "seq": "2256",
              "speed": "3.5460000038146977",
              "time": "2014-10-05T17:22:17.000Z",
              "type": "Trackpoint"
            }
        
        Source Code
        ===========
        
        See `ggps at GitHub <https://github.com/cjoakim/ggps>`_ .
        
        Includes sample data files.
        
        
        Changelog
        =========
        
        Version 0.1.7
        -------------
        
        -  2016/11/06. Version 0.1.7, updated description
        -  2016/11/06. Version 0.1.6, republished
        -  2016/11/06. Version 0.1.5, refactored ggps/ dir.
        -  2016/11/06. Version 0.1.4, refactored ggps/ dir. nose2 for tests
        -  2015/11/07. Version 0.1.3, README.rst
        -  2015/11/07. Version 0.1.1
        
Keywords: garmin gps gpx tcx parsing utilities m26
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
