The hardware and bandwidth for this mirror is donated by dogado GmbH, the Webhosting and Full Service-Cloud Provider. Check out our Wordpress Tutorial.
If you wish to report a bug, or if you are interested in having us mirror your free-software or open-source project, please feel free to contact us at mirror[@]dogado.de.
stplanr is a package for sustainable transport planning with R.
It provides functions for solving common problems in transport planning and modelling, such as how to best get from point A to point B. The overall aim is to provide a reproducible, transparent and accessible toolkit to help people better understand transport systems and inform policy, as outlined in a paper about the package, and the potential for open source software in transport planning in general, published in the R Journal.
The initial work on the project was funded by the Department of Transport (DfT) as part of the development of the Propensity to Cycle Tool (PCT), a web application to explore current travel patterns and cycling potential at zone, desire line, route and route network levels (see www.pct.bike and click on a region to try it out). The basis of the methods underlying the PCT is origin-destination data, which are used to highlight where many short distance trips are being made, and estimate how many could switch to cycling. The results help identify where cycleways are most needed, an important component of sustainable transport planning infrastructure engineering and policy design.
See the package vignette (e.g. via
vignette("introducing-stplanr")) or an academic paper on the
Propensity to Cycle Tool (PCT) for more information on how it can be
used. This README provides some basics.
Much of the work supports research undertaken at the Leeds’ Institute for Transport Studies (ITS) but stplanr should be useful to transport researchers and practitioners needing free, open and reproducible methods for working with geographic data everywhere.
Data frames representing flows between origins and destinations must
be combined with geo-referenced zones or points to generate meaningful
analyses and visualisations of ‘flows’ or origin-destination (OD) data.
stplanr facilitates this with od2line(),
which takes flow and geographical data as inputs and outputs spatial
data. Some example data is provided in the package:
library(stplanr)Let’s take a look at this data:
od_data_sample[1:3, 1:3] # typical form of flow data
#> # A tibble: 3 × 3
#> geo_code1 geo_code2 all
#> <chr> <chr> <dbl>
#> 1 E02002361 E02002361 109
#> 2 E02002361 E02002363 38
#> 3 E02002361 E02002367 10
cents_sf[1:3,] # points representing origins and destinations
#> geo_code MSOA11NM percent_fem avslope geometry
#> 1708 E02002384 Leeds 055 0.458721 2.856563 -1.546463, 53.809517
#> 1712 E02002382 Leeds 053 0.438144 2.284782 -1.511861, 53.811611
#> 1805 E02002393 Leeds 064 0.408759 2.361707 -1.524205, 53.804098These datasets can be combined as follows:
travel_network <- od2line(flow = od_data_sample, zones = cents_sf)
w <- flow$all / max(flow$all) *10
plot(travel_network, lwd = w)
stplanr has many functions for working with OD data.
See the stplanr-od
vignette for details.
The package can also allocate flows to the road network, e.g. with CycleStreets.net and the
OpenStreetMap Routing Machine (OSRM) API
interfaces. These are supported in route_*() functions such
as route_cyclestreets and route_osrm():
Routing can be done using a range of back-ends and using lat/lon or
desire line inputs with the route() function, as
illustrated by the following commands which calculates the route between
Fleet Street and Southwark Street over the River Thames on Blackfriars
Bridge in London:
library(osrm)
#> Data: (c) OpenStreetMap contributors, ODbL 1.0 - http://www.openstreetmap.org/copyright
#> Routing: OSRM - http://project-osrm.org/
trip <- route(
from = c(-0.11, 51.514),
to = c(-0.10, 51.506),
route_fun = osrmRoute,
returnclass = "sf"
)
#> Warning: "returnclass" is deprecated.
#> Most common output is sf
plot(trip)
You can also use and place names, found using the Google Map API:
trip2 <- route(
from = "Leeds",
to = "Bradford",
route_fun = osrmRoute,
returnclass = "sf"
)
#> Warning: "returnclass" is deprecated.
#> Most common output is sf
plot(trip2)
We can replicate this call multiple times with the l
argument in route():
desire_lines <- travel_network[2:6, ]Next, we’ll calculate the routes:
routes <- route(
l = desire_lines,
route_fun = osrmRoute,
returnclass = "sf"
)
#> Warning: "returnclass" is deprecated.
#> Warning: "returnclass" is deprecated.
#> Warning: "returnclass" is deprecated.
#> Warning: "returnclass" is deprecated.
#> Warning: "returnclass" is deprecated.
plot(sf::st_geometry(routes))
plot(desire_lines, col = "red", add = TRUE)
#> Warning in plot.sf(desire_lines, col = "red", add = TRUE): ignoring all but the
#> first attribute
For more examples, example("route").
overline() takes a series of route-allocated lines,
splits them into unique segments and aggregates the values of
overlapping lines. This can represent where there will be most traffic
on the transport system, as demonstrated in the following code
chunk.
routes$foot <- desire_lines$foot
rnet <- overline(routes, attrib = "foot")The resulting route network, with segment totals calculated from overlapping parts for the routes for walking, can be visualised as follows:
plot(rnet["foot"], lwd = rnet$foot)
The above plot represents the number walking trips made (the ‘flow’) along particular segments of a transport network.
The examples shown above, based on tiny demonstration datasets, may not seem particularly revolutionary. At the city scale, however, this type of analysis can be used to inform sustainable transport policies, as described in papers describing the Propensity to Cycle Tool (PCT), and its application to calculate cycling to school potential across England.
Results generated by stplanr are now part of national government policy: the PCT is the recommended tool for local and regional authorities developing strategic cycle network under the Cycling and Walking Infrastructure Strategy (CWIS), which is part of the Infrastructure Act 2015. stplanr is helping dozens of local authorities across the UK to answer the question: where to prioritise investment in cycling? In essence, stplanr was designed to support sustainable transport policies.
There are many other research and policy questions that functions in stplanr, and other open source software libraries and packages, can help answer. At a time of climate, health and social crises, it is important that technology is not only sustainable itself (e.g. as enabled by open source communities and licenses) but that it contributes to a sustainable future.
To install the stable version, use:
install.packages("stplanr")The development version can be installed using devtools:
# install.packages("devtools") # if not already installed
devtools::install_github("ropensci/stplanr")
library(stplanr)stplanr depends on sf. Installation instructions for Mac, Ubuntu and other Linux distros can be found here: https://github.com/r-spatial/sf#installing
The current list of available functions can be seen on the package’s website at docs.ropensci.org/stplanr/, or with the following command:
lsf.str("package:stplanr", all = TRUE)To get internal help on a specific function, use the standard way.
?od2lineTo contribute, report bugs or request features, see the issue tracker.
Want to learn how to use open source software for reproducible sustainable transport planning work? Now is a great time to learn. Transport planning is a relatively new field of application in R. However, there are already some good resources on the topic, including (any further suggestions: welcome):
dodgr vignette, which provides an introduction to
routing in R: https://github.com/UrbanAnalyst/dodgrcitation(package = 'stplanr')
These binaries (installable software) and packages are in development.
They may not be fully stable and should be used with caution. We make no claims about them.
Health stats visible at Monitor.