Utils

Helper functions and classes.

Modules

For readability, the full path is listed below and not used in other parts of the documentation.

• mappymatch.utils.exceptions

• mappymatch.utils.geo

• mappymatch.utils.plot

• mappymatch.utils.trace

• mappymatch.utils.url

exceptions module

exception MapException

An exception for any errors that occur with the MapInterface

geo module

coord_to_coord_dist(a: Coordinate, b: Coordinate) → float

Compute the distance between two coordinates.

Parameters:

• a – The first coordinate

• b – The second coordinate

Returns:

The distance in meters

latlon_to_xy(lat: float, lon: float) → Tuple[float, float]

Tramsform lat,lon coordinates to x and y.

Parameters:

• lat – The latitude.

• lon – The longitude.

Returns:

Transformed x and y as x, y.

xy_to_latlon(x: float, y: float) → Tuple[float, float]

Tramsform x,y coordinates to lat and lon

Parameters:

• x –

• y –

Returns:

Transformed lat and lon as lat, lon.

plot module

plot_geofence(geofence: Geofence, m: Map | None = None)

Plot geofence.

Parameters:

• geofence – The geofence to plot

• m – the folium map to plot on

Returns:

The updated folium map with the geofence.

plot_map(tmap: NxMap, m: Map | None = None)

Plot the roads on an NxMap.

Parameters:

• tmap – The Nxmap to plot.

• m – the folium map to add to

Returns:

The folium map with the roads plotted.

plot_match_distances(matches: MatchResult)

Plot the points deviance from known roads with matplotlib.

Parameters:

matches (MatchResult) – The coordinates of guessed points in the area in the form of a MatchResult object.

plot_matches(matches: ~mappymatch.matchers.match_result.MatchResult | ~typing.List[~mappymatch.constructs.match.Match], crs=<Projected CRS: EPSG:3857> Name: WGS 84 / Pseudo-Mercator Axis Info [cartesian]: - X[east]: Easting (metre) - Y[north]: Northing (metre) Area of Use: - name: World between 85.06°S and 85.06°N. - bounds: (-180.0, -85.06, 180.0, 85.06) Coordinate Operation: - name: Popular Visualisation Pseudo-Mercator - method: Popular Visualisation Pseudo Mercator Datum: World Geodetic System 1984 ensemble - Ellipsoid: WGS 84 - Prime Meridian: Greenwich )

Plots a trace and the relevant matches on a folium map.

Args: matches: A list of matches or a MatchResult. crs: what crs to plot in. Defaults to XY_CRS.

Returns:

A folium map with trace and matches plotted.

plot_path(path: List[Road], crs: CRS, m: Map | None = None, line_color='red', line_weight=10, line_opacity=0.8)

Plot a list of roads.

Parameters:

• path – The path to plot.

• crs – The crs of the path.

• m – The folium map to add to.

• line_color – The color of the line.

• line_weight – The weight of the line.

• line_opacity – The opacity of the line.

plot_trace(trace: Trace, m: Map | None = None, point_color: str = 'black', line_color: str | None = 'green')

Plot a trace.

Parameters:

• trace – The trace.

• m – the folium map to plot on

• point_color – The color the points will be plotted in.

• line_color – The color for lines. If None, no lines will be plotted.

Returns:

An updated folium map with a plot of trace.

trace module

remove_bad_start_from_trace(trace: Trace, distance_threshold: float) → Trace

Remove points at the beginning of a trace if it is a gap is too big.

Too big is defined by distance threshold.

Parameters:

• trace – The trace.

• distance_threshold – The distance threshold.

Returns:

The new trace.

split_large_trace(trace: Trace, ideal_size: int) → list[Trace]

Split up a trace into a list of smaller traces.

Parameters:

• trace – the trace to split.

• ideal_size – the target number of coordinates for each new trace.

Returns:

A list of split traces.

url module

multiurljoin(urls: List[str]) → str

Make a url from uri’s.

Parameters:

urls – list of uri

Returns:

Url as uri/uri/…