Command line tool for measuring the straightness of a gpx track
Project description
linesman
linesman
is a small python command line tool calculating quality measures for
the straightness of a gpx track. The project is inspired by the "I attempted to
cross <country> in a completely straight line" series of youtuber
GeoWizard.
Installation
As a python package, linesman
is installed with
pip. The
package is named gpx-linesman
:
pip install gpx-linesman
After installing the package, you should be able to run linesman:
linesman --help
Usage
linesman
must be passed a gpx file with the recorded track and a quality
measure that shall be used to compare the gpx track against the reference line:
linesman path/to/file.gpx <measure>
Currently, the following quality measures are implemented:
MAX
: maximum deviation from the reference line in metersAVG
: average deviation in metersSQ-AVG
: squared deviation average in meters
Development
Python dependencies are managed with poetry and can be installed from
poetry.lock
by running:
poetry install
Then, the CLI tool can be started with poetry run linesman
. Run tests with
poetry run pytest
.
Documentation
Conceptual documentation can be found on readthedocs.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gpx_linesman-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 24dc6d2723624df4a3f22bd8fa60d04db58d3270ee0e9b9997317fbf96dc0a17 |
|
MD5 | 79f661a8b61fe1aa906f811b45b5e8ed |
|
BLAKE2b-256 | 4d7ffe5ef511a70c2eeb9fc4f69d05356f263cfead378d7ae6aa370f6c9dff57 |