Home

Awesome

OpenStreetMapXPlot.jl

Documentation

This is a plotting companion for the OpenStreetMapX.jl package.

The package provides plotting mechanisms for map vizualization via Plots.jl. The recommended backend is gr()

Installation

The current version has been tested with Julia 1.9 and up

using Pkg
pkg"add OpenStreetMapX"
pkg"add OpenStreetMapXPlot"

Usage

We will show a full scenario including routing. Let us start by preparing the data and calculating a sample route.

using OpenStreetMapX

m =  get_map_data(sample_map_path(), use_cache = false);
import Random
Random.seed!(0);
pointA = point_to_nodes(generate_point_in_bounds(m), m)
pointB = point_to_nodes(generate_point_in_bounds(m), m)
sr = shortest_route(m, pointA, pointB)[1]

Once the map data is in the memory we can start plotting. Let us start with Plots.jl with a GR back-end (this is the recommended approach due to GR's plotting speed, however due to Julia compiling process time-to-the-first-plot is around one minute, while subsequent plots can be created within few seconds).

using OpenStreetMapXPlot
using Plots, Colors
Plots.gr()
p = OpenStreetMapXPlot.plotmap(m,width=600,height=400);
addroute!(p,m,sr;route_color=colorant"red");
plot_nodes!(p,m,[sr[1],sr[end]],start_numbering_from=nothing,fontsize=13,color=colorant"blue");
p

Acknowledgments

<sup>This code is a major re-write of plotting functionality of https://github.com/tedsteiner/OpenStreetMap.jl project. The creation of this source code was partially financed by research project supported by the Ontario Centres of Excellence ("OCE") under Voucher for Innovation and Productivity (VIP) program, OCE Project Number: 30293, project name: "Agent-based simulation modelling of out-of-home advertising viewing opportunity conducted in cooperation with Environics Analytics of Toronto, Canada. </sup>