Metadata-Version: 2.1
Name: gpx-parser
Version: 0.0.4
Summary: Simple parser for gpx tracks, segments, and points with latitude, longitude, and time.
Home-page: https://github.com/kholkolg/gpx_parser
Author: Olga Kholkovskaia
Author-email: olga.kholkovskaia@gmail.com
License: MIT
Download-URL: https://github.com/kholkolg/gpx_parser/
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.4
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: typing (==3.6.2)

# gpx-parser

Simple parser for loading basic information about track points from .gpx files.
Inside the gpx tag parser only extracts trk, trkseg, and trkpt tags.
All other tags are ignored.
Resulting GPX structure is a container with track list. Each track is in it's turn a list of segments, and segment is
a list of track points, the leaf elements of the structure.
GPX, GPXTrack, an GPXTrackSegment support most of the list methods.


### Prerequisites
Python 3.4 or higher

xml or lxml


### Examples of usage
```python
import gpx_parser as parser

with open('file_name', 'r') as gpx_file:
    gpx = parser.parse(gpx_file)
print("{} tracks loaded".format(len(gpx)))
```

```
for track in gpx:
    print('Track with {} segments and {} points'.
          format(len(track), track.get_points_no()))
    for segment in track:
        print('Segment with %s points % len(segment))
        for point in segment:
            print(point)

```
##### GPX

```
gpx.tracks                   # list of tracks
gpx.version                  # str or None
gpx.creator                  # str or None
gpx.points                   # list of all points from all tracks

len(gpx))                    # number of tracks in gpx
gpx.get_points_no()          # total number of points in all segments of all tracks
gpx[0]                       # 0th track, same as gpx.tracks[0]
gpx[1:3]                     # = gpx.tracks[1:3]
gpx.contains(track)          # = gpx.tracks.contains(track)
gpx.append(track)            # = gpx.tracks.append(track)
gpx.extend(tracks)           # = gpx.tracks.extend(tracks)
gpx.remove(track)            # = gpx.tracks.remove(tracks)
gpx.clone()                  #  returns deepcoopy of the object   

gpx.to_xml()                 # str, point with xml tags
gpx.length_2d()              # total 2d  distance of the track
gpx.get_bounds()             # min and max latitude and logitude
gpx.get_time_bounds()        # start and end time
gpx.walk()                   # generator, yields (point, track_num, segment_num, point_num)

```
##### GPXTrack
 ```
 track.name                 # str or None
 track.number               # int or None
 track.segments             # list of all segments in the track
 track.points               # list of all points from all segments

 len(track)                 # number of segments in the track
 track[0]                   #
 track[::2]                 # shorcuts for
 track.contains(segment)    # track.segments
 track.append(segment)      #
 track.extend(segmengs)     #
 track.remove(segment)      #


 track.to_xml()             #
 track.length_2d()          # same as for gpx
 track.get_bounds()         #
 track.get_time_bounds()    #
 track.get_points_no()      #
 track.clone()              #

 track.get_duration()      # float, duration of track in seconds
 track.remove_empty()      # removes empty segments from the track

```
##### GPXTrackSegment

```
 seg.points               # list of points in the segment

 len(seg)                 # 
 seg[0]                   #
 seg[::2]                 # shortcuts for
 seg.contains(segment)    # seg.points
 seg.append(segment)      #
 seg.extend(segmengs)     #
 seg.remove(segment)      #


 seg.to_xml()             #
 seg.length_2d()          # same as for gpx
 seg.get_bounds()         #
 seg.get_time_bounds()    #
 seg.get_points_no()      #
 seg.clone()              # 

 seg.get_duration()       # float, duration of track in seconds
 seg.remove_empty()       # removes empty segments from the track

```
 ##### GPXTrackPoint
 ```
 point.latitude         
 point.longitude        
 point.time             

 point.to_xml()         

 point.distance_2d(other_point)          # distance in meters
 point.time_difference(other_point)      # time in seconds, or None, if one of the points doesn't have time attribute.
 point.speed_between(other_point)        # speed, i m/s, or None, if one of the points doesn't have time attribute.
```

