Package for mapmatching.
Project description
mappymatch
mappymatch is a pure-python package developed by the National Renewable Energy Laboratory that maintains a collection of map matching algorithms and wrappers. The package was designed for ease of use and portabilty across platforms.
Installation
Check out the docs for install instructions.
Example Usage
The current primary workflow is to use osmnx to download a road network and match it using the LCSSMatcher
.
The LCSSMatcher
implements the map matching algorithm described in this paper:
usage:
from mappymatch import package_root
from mappymatch.constructs.geofence import Geofence
from mappymatch.constructs.trace import Trace
from mappymatch.maps.nx.nx_map import NxMap
from mappymatch.matchers.lcss.lcss import LCSSMatcher
trace = Trace.from_csv(root() / "resources/traces/sample_trace_1.csv")
# generate a geofence polygon that surrounds the trace; units are in meters;
# this is used to query OSM for a small map that we can match to
geofence = Geofence.from_trace(trace, padding=1e3)
# uses osmnx to pull a networkx map from the OSM database
nx_map = NxMap.from_geofence(geofence)
matcher = LCSSMatcher(nx_map)
matches = matcher.match_trace(trace)
Example Notebooks
Example JupyterLab notebooks making use of mappymatch can be found in the mappymatch examples repository.
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
mappymatch-0.2.3.tar.gz
(24.2 kB
view hashes)
Built Distribution
mappymatch-0.2.3-py3-none-any.whl
(30.0 kB
view hashes)
Close
Hashes for mappymatch-0.2.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 65a66d600ba45a852221091852d5a2ce44f36176eed7b6b886d6932990c27ad4 |
|
MD5 | 8caebdd4de71707e478fab58fd8d3489 |
|
BLAKE2b-256 | a578615f2a08f30662d03cff29edeb4d6146114146c97d202f370b58be835c19 |