A module to read GPMF data embedded in GoPro video files.
Project description
pygpmf
A python Module to extract GPMF information from Videos
More information on the format is available on the GoPro GitHub page.
The primay aim of this project was to be able to extract GPS tracks from GoPro video files, so the GPS part is more tested.
We use python-ffmpeg
to extract the GPMF stream from video files.
import gpmf
# Read the binary stream from the file
stream = gpmf.io.extract_gpmf_stream(my_file)
# Extract GPS low level data from the stream
gps_blocks = gpmf.gps.extract_gps_blocks(stream)
# Parse low level data into more usable format
gps_data = list(map(gpmf.gps.parse_gps_block, gps_blocks))
We rely on gpxpy
to easily convert GPS data into GPX segments:
import gpxpy
gpx = gpxpy.gpx.GPX()
gpx_track = gpxpy.gpx.GPXTrack()
gpx.tracks.append(gpx_track)
gpx_track.segments.append(gpmf.gps.make_pgx_segment(gps_data))
print(gpx.to_xml())
<?xml version="1.0" encoding="UTF-8"?>
<gpx xmlns="http://www.topografix.com/GPX/1/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.topografix.com/GPX/1/1 http://www.topografix.com/GPX/1/1/gpx.xsd" version="1.1" creator="gpx.py -- https://github.com/tkrajina/gpxpy">
<trk>
<trkseg>
<trkpt lat="44.1287283" lon="5.427715">
<ele>833.759</ele>
<time>2020-07-03T12:36:56.940000Z</time>
<sym>Square</sym>
<fix>3d</fix>
<pdop>1.82</pdop>
<extensions>
<speed_2d>
<value>9.221</value>
<unit>m/s</unit>
</speed_2d>
<speed_3d>
<value>9.25</value>
<unit>m/s</unit>
</speed_3d>
</extensions>
</trkpt>
...
</trkseg>
</trk>
</gpx>
You can also make an image from you gps track:
import gpmf
# Read the binary stream from the file
stream = gpmf.io.extract_gpmf_stream(my_file)
gpmf.gps_plot.plot_gps_trace_from_stream(stream)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gpmf-0.1.tar.gz
(9.0 kB
view hashes)
Built Distribution
gpmf-0.1-py3-none-any.whl
(16.2 kB
view hashes)