From e0cd6eb668345bf4c9c13ec40eef7747fc52c2e1 Mon Sep 17 00:00:00 2001 From: Robin Lovelace Date: Mon, 14 Nov 2022 09:40:05 +0000 Subject: [PATCH] 505 functions to do spatial joins between route networks (#506) * Add starter on rnet join #505 * Add example dataset for #505 * Add example code #505 * Document and tidy * Update docs * Update docs * Minor fixes to docs * Update docs --- NAMESPACE | 4 + R/data.R | 15 +- R/rnet_join.R | 146 +++ _pkgdown.yml | 1 + data-raw/route_network_small.R | 25 + data/osm_net_example.rda | Bin 7798 -> 7787 bytes data/route_network_small.rda | Bin 0 -> 2026 bytes docs/CONDUCT.html | 271 ++--- docs/LICENSE-text.html | 269 ++--- docs/articles/index.html | 292 ++--- docs/articles/stplanr-paper.html | 1331 +++++++++++++++------- docs/authors.html | 356 +++--- docs/index.html | 462 ++++---- docs/news/index.html | 1274 +++++++++------------ docs/pkgdown.yml | 2 +- docs/reference/angle_diff.html | 408 +++---- docs/reference/bbox_scale-1.png | Bin 23750 -> 23949 bytes docs/reference/bbox_scale.html | 346 +++--- docs/reference/flow.html | 372 +++---- docs/reference/flow_dests.html | 342 +++--- docs/reference/geo_bb-1.png | Bin 37097 -> 35460 bytes docs/reference/geo_bb.html | 379 +++---- docs/reference/geo_bb_matrix.html | 352 +++--- docs/reference/geo_buffer.html | 378 +++---- docs/reference/geo_code.html | 361 +++--- docs/reference/geo_length.html | 343 +++--- docs/reference/geo_projected.html | 395 +++---- docs/reference/geo_select_aeq.html | 406 +++---- docs/reference/geo_toptail.html | 394 +++---- docs/reference/gsection.html | 382 +++---- docs/reference/index.html | 1414 +++++++++++------------- docs/reference/is_linepoint.html | 361 +++--- docs/reference/islines.html | 353 ++---- docs/reference/line2df.html | 378 +++---- docs/reference/line2points-2.png | Bin 26845 -> 25427 bytes docs/reference/line2points.html | 394 +++---- docs/reference/line_bearing.html | 382 +++---- docs/reference/line_midpoint.html | 365 +++--- docs/reference/line_segment-1.png | Bin 20837 -> 17909 bytes docs/reference/line_segment.html | 371 +++---- docs/reference/line_via.html | 405 +++---- docs/reference/mats2line.html | 379 +++---- docs/reference/n_vertices.html | 360 +++--- docs/reference/od2line-1.png | Bin 56996 -> 57018 bytes docs/reference/od2line.html | 491 +++----- docs/reference/od2odf.html | 365 +++--- docs/reference/od_coords.html | 386 +++---- docs/reference/od_id_order.html | 358 +++--- docs/reference/onewaygeo.html | 384 +++---- docs/reference/overline-1.png | Bin 31285 -> 31316 bytes docs/reference/overline-2.png | Bin 48795 -> 48895 bytes docs/reference/overline.html | 526 ++++----- docs/reference/pipe.html | 279 ++--- docs/reference/points2flow-1.png | Bin 53166 -> 63853 bytes docs/reference/points2flow.html | 345 ++---- docs/reference/points2line-1.png | Bin 6010 -> 302165 bytes docs/reference/points2line.html | 361 +++--- docs/reference/points2odf.html | 407 ++++--- docs/reference/quadrant-1.png | Bin 37150 -> 36526 bytes docs/reference/quadrant.html | 353 +++--- docs/reference/read_table_builder.html | 350 +++--- docs/reference/route.html | 422 +++---- docs/reference/route_osrm.html | 352 +++--- docs/reference/stplanr-package.html | 293 ++--- docs/reference/toptail_buff-1.png | Bin 39673 -> 39675 bytes docs/reference/toptail_buff.html | 380 +++---- man/cents_sf.Rd | 1 + man/destinations_sf.Rd | 1 + man/flow.Rd | 2 + man/flow_dests.Rd | 1 + man/flowlines_sf.Rd | 1 + man/line_cast.Rd | 14 + man/od_data_lines.Rd | 1 + man/od_data_routes.Rd | 1 + man/od_data_sample.Rd | 1 + man/osm_net_example.Rd | 1 + man/read_table_builder.Rd | 1 + man/rnet_join.Rd | 95 ++ man/rnet_split_lines.Rd | 20 + man/rnet_subset.Rd | 24 + man/route_network_sf.Rd | 3 +- man/route_network_small.Rd | 32 + man/routes_fast_sf.Rd | 1 + man/routes_slow_sf.Rd | 1 + man/zones_sf.Rd | 1 + 85 files changed, 8549 insertions(+), 12173 deletions(-) create mode 100644 R/rnet_join.R create mode 100644 data-raw/route_network_small.R create mode 100644 data/route_network_small.rda create mode 100644 man/line_cast.Rd create mode 100644 man/rnet_join.Rd create mode 100644 man/rnet_split_lines.Rd create mode 100644 man/rnet_subset.Rd create mode 100644 man/route_network_small.Rd diff --git a/NAMESPACE b/NAMESPACE index f30348ae..810b4d6e 100644 --- a/NAMESPACE +++ b/NAMESPACE @@ -53,6 +53,7 @@ export(line2pointsn) export(line2vertices) export(line_bearing) export(line_breakup) +export(line_cast) export(line_midpoint) export(line_segment) export(line_via) @@ -89,6 +90,9 @@ export(rnet_breakup_vertices) export(rnet_duplicated_vertices) export(rnet_get_nodes) export(rnet_group) +export(rnet_join) +export(rnet_split_lines) +export(rnet_subset) export(route) export(route_average_gradient) export(route_dodgr) diff --git a/R/data.R b/R/data.R index 7768f15b..2af721fe 100644 --- a/R/data.R +++ b/R/data.R @@ -125,7 +125,7 @@ NULL #' @format A spatial lines dataset with 49 rows and 15 columns NULL -#' spatial lines dataset representing a route network +#' Spatial lines dataset representing a route network #' #' #' The flow of commuters using different segments of the road network represented in the @@ -138,6 +138,19 @@ NULL #' @format A spatial lines dataset 80 rows and 1 column NULL +#' Spatial lines dataset representing a small route network +#' +#' +#' The flow between randomly selected vertices on the `osm_net_example`. +#' See `data-raw/route_network_small.R` for details. +#' +#' @family data +#' @docType data +#' @keywords datasets +#' @name route_network_small +#' @format A spatial lines dataset with one column: flow +NULL + #' Example of OpenStreetMap road network #' @docType data #' @keywords datasets diff --git a/R/rnet_join.R b/R/rnet_join.R new file mode 100644 index 00000000..33c8fe30 --- /dev/null +++ b/R/rnet_join.R @@ -0,0 +1,146 @@ +#' Join route networks +#' +#' This is a spatial join function that is enables adding columns to a +#' 'target' route network from a 'source' route +#' network that contains the base geometry, e.g. from OSM +#' +#' The output is an sf object containing polygons representing +#' buffers around the route network in `rnet_x`. +#' The examples below demonstrate how to join attributes from +#' a route network object created with the function [overline()] onto +#' OSM geometries. +#' +#' Note: The main purpose of this function is to join an ID from `rnet_x` +#' onto `rnet_y`. Subsequent steps, e.g. with [dplyr::inner_join()] +#' are needed to join the attributes back onto `rnet_x`. +#' There are rarely 1-to-1 relationships between spatial network geometries +#' so we take care when using this function. +#' +#' See [#505](https://github.com/ropensci/stplanr/issues/505) for details +#' and a link to an interactive example of inputs and outputs shown below. +#' +#' @param rnet_x Target route network, the output will have the same geometries +#' as features in this object. +#' @param rnet_y Source route network. Columns from this route network object will +#' be copied across to the new network. +#' @param dist The buffer width around rnet_y in meters. 1 m by default. +#' @param length_y Add a new column called `length_y`? Useful when joining based on +#' length of segments (e.g. weighted mean). `TRUE` by default. +#' @param key_column The index of the key (unique identifier) column in `rnet_x`. +#' @param subset_x Subset the source route network by the target network before +#' creating buffers? This can lead to faster and better results. Default: +#' `TRUE`. +#' @param dist_subset The buffer distance in m to apply when breaking up the +#' source object `rnet_y`. Default: 5. +#' @param split_y Should the second route network be split at the start and +#' end points of LINESTRING features in the first? `TRUE` by default. +#' @param ... Additional arguments passed to `rnet_subset`. +#' @examples +#' library(sf) +#' library(dplyr) +#' # Uncomment for interactive examples: +#' plot(route_network_small["flow"]) +#' plot(osm_net_example$geometry, lwd = 5, col = "grey") +#' plot(route_network_small["flow"], add = TRUE) +#' rnetj = rnet_join(osm_net_example, route_network_small, dist = 9) +#' # library(mapview) +#' # mapview(rnetj, zcol = "flow") + +#' # mapview(route_network_small, zcol = "flow") +#' plot(rnetj["flow"]) +#' plot(route_network_small["flow"], add = TRUE) +#' rnetj_summary = rnetj %>% +#' sf::st_drop_geometry() %>% +#' group_by(osm_id) %>% +#' summarise( +#' flow = weighted.mean(flow, length_y, na.rm = TRUE), +#' ) +#' osm_joined_rnet = left_join(osm_net_example, rnetj_summary) +#' plot(route_network_small["flow"]) +#' plot(osm_joined_rnet[c("flow")]) +#' # Improve fit between geometries and performance by subsetting rnet_x +#' osm_subset = rnet_subset(osm_net_example, route_network_small, dist = 5) +#' osm_joined_rnet = left_join(osm_subset, rnetj_summary) +#' plot(route_network_small["flow"]) +#' plot(osm_joined_rnet[c("flow")]) +#' # mapview(joined_network) + +#' # mapview(route_network_small) +#' @export +rnet_join = function(rnet_x, rnet_y, dist = 5, length_y = TRUE, key_column = 1, + subset_x = TRUE, dist_subset = 5, split_y = TRUE, ...) { + if (subset_x) { + rnet_x = rnet_subset(rnet_x, rnet_y, dist = dist_subset, ...) + } + rnet_x_buffer = geo_buffer(rnet_x, dist = dist, nQuadSegs = 2) + if (split_y) { + rnet_y = rnet_split_lines(rnet_y, rnet_x, dist = dist_subset) + } + if (length_y) { + rnet_y$length_y = as.numeric(sf::st_length(rnet_y)) + } + rnetj = sf::st_join(rnet_x_buffer[key_column], rnet_y, join = sf::st_contains) + rnetj +} + +#' Subset one route network based on overlaps with another +#' +#' @param rnet_x The route network to be subset +#' @param rnet_y The subsetting route network +#' @param dist The buffer width around y in meters. 1 m by default. +#' @param crop Crop `rnet_x`? `TRUE` is the default +#' @param min_x Segments shorter than this multiple of dist +#' *and* which were longer +#' before the cropping process will be removed. 3 by default. +#' @export +rnet_subset = function(rnet_x, rnet_y, dist = 1, crop = TRUE, min_x = 3) { + rnet_x$length_x_original = as.numeric(sf::st_length(rnet_x)) + rnet_y_union = sf::st_union(rnet_y) + rnet_y_buffer = stplanr::geo_buffer(rnet_y_union, dist = dist, nQuadSegs = 2) + if(crop) { + rnet_x = sf::st_intersection(rnet_x, rnet_y_buffer) + rnet_x = line_cast(rnet_x) + rnet_x$length_x_cropped = as.numeric(sf::st_length(rnet_x)) + min_length = dist * min_x + sel_short = rnet_x$length_x_cropped < min_length & + rnet_x$length_x_original > min_length + rnet_x = rnet_x[!sel_short, ] + } else { + rnet_x[rnet_y_buffer, , op = sf::st_within] + } + rnet_x +} +#' Split lines in a route network based points +#' +#' If the object passed to the second argument has LINSTRING geometries +#' the start and end points of linestrings are used. +#' +#' @param rnet_x The route network to be broken into smaller pieces +#' @param geo_y The geographic object used to break up the route network +#' @param dist The width of the buffer used when breaking up the route network. +#' For imprecise data it may be worth increasing this above 1 m, the default. +#' @export +rnet_split_lines = function(rnet_x, geo_y, dist = 1) { + if (all(grepl(pattern = "LINE", x = sf::st_geometry_type(rnet_x)))) { + geo_y = c( + lwgeom::st_startpoint(geo_y), + lwgeom::st_endpoint(geo_y) + ) + } + # speed-up subsequent steps: + points = sf::st_union(geo_y) + points_buffer = stplanr::geo_buffer(points, dist = dist) + rnet_split = sf::st_difference(rnet_x, points_buffer) + rnet_split_lines = line_cast(rnet_split) + rnet_split_lines$length_osm_cast = as.numeric(sf::st_length(rnet_split_lines)) + # rnet_split_lines[rnet_split_lines$length_osm_cast > min_lenth, ] + rnet_split_lines +} + +#' Convert multilinestring object into linestrings +#' +#' Without losing vertices +#' +#' @param x Linestring object +#' @export +line_cast = function(x) { + sf::st_cast(sf::st_cast(x, "MULTILINESTRING"), "LINESTRING") +} diff --git a/_pkgdown.yml b/_pkgdown.yml index 9902bbde..45b28760 100644 --- a/_pkgdown.yml +++ b/_pkgdown.yml @@ -12,6 +12,7 @@ reference: - title: Work with (desire) lines contents: - has_concept("lines") + - starts_with("line") - title: Work with and analyse routes contents: - has_concept("route_funs") diff --git a/data-raw/route_network_small.R b/data-raw/route_network_small.R new file mode 100644 index 00000000..c5e7b0fe --- /dev/null +++ b/data-raw/route_network_small.R @@ -0,0 +1,25 @@ +## code to prepare `route_network_small` dataset goes here + +# Create route network focussed on OSM data +library(tidyverse) +osm_vertices = sf::st_cast(osm_net_example, to = "POINT") +plot(osm_vertices$geometry) +set.seed(2022) +osm_vertices_random = osm_vertices %>% + sample_n(size = 9) + +desire_lines = od::points_to_odl(p = osm_vertices_random) +plot(desire_lines) +desire_lines$length = sf::st_length(desire_lines) %>% as.numeric() +summary(desire_lines$length) +desire_lines_long = desire_lines %>% + filter(length > 100) + +routes = route(l = desire_lines_long, route_fun = stplanr::route_osrm) +routes$flow = seq(nrow(routes)) +route_network_small = overline(routes, attrib = "flow") +plot(osm_net_example$geometry, lwd = 5, col = "grey") +route_network_small %>% + select(flow) %>% + plot(add = TRUE) +usethis::use_data(route_network_small, overwrite = TRUE) diff --git a/data/osm_net_example.rda b/data/osm_net_example.rda index c3b63d4dca2a6422b373ff3b2a87d5f9a0d64262..e3d01652fa11c1c5c7b62d8f50822068e63ca5af 100644 GIT binary patch literal 7787 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 D?9_bP diff --git a/data/route_network_small.rda b/data/route_network_small.rda new file mode 100644 index 0000000000000000000000000000000000000000..4b3f6c09ad1e88323c35a6835098168c2c5be342 GIT binary patch literal 2026 zcmVO6?aqsba+rh`vWqcnl(r~ukSPgB$ydYL?$YG`N=NcB9XLA04NdY-40KmY&$00006 zfEoY*00006fEpS!02%-Q0009Z0000Q007aGKs160kvx%<@R~D9pQ-Ab)jds<(3)u* z5j{pG)MPOjPej@giGXRL8$%@YO%0(i5vCAeAjD!Gh|@+0JxnH=WWWM6dJq5r00000 z0iXte000000iXtkjQ|FK00000$N&HU27mxGWY7sDf&r2Cg0{$36`B?=TOd^C5SrIji`J2e% zReFg)p1(-ZKXnu27x>#;gp5sJMA|A@Q6(+iWn{oa36c;D$sjAhb%V<36PSi#396dDsYf)Y@M%Y;FuF63H?aI7VfWBTRR|bKrBZxTnl%F6y@5^mx1$3+vO)JW7D%oGhx#WPZJLOs$`g zJGi3v93U$T(Ys$SadX+q_*bP78C$d3tSj>p#sH3B%Zw~!hD(i6?yU}LD0p(ABbtcq*&<|(WVeI>WT7IL1&m7WJ7}70g8^x4Iy9j0 zj7&XH+IHC~FM$R$GYygpdrM~SV45d<)Ovn(`5jR0`%I-uWf?TgI17NMLW%lA!+;=# z)}V~rM6nss5d4XHDcni6euS$YwRc3+bkT4X6rN>v2KBE+jP~(#E|sC^lorJ}LoL7B zCQNOm0&@-EXUer(u2?^sl!vRyf{Vw$#Knz8h z5->msdrd+ud<2e$n6++r(7U0P;XRE^K<}8Oq)KSdy+t=ajiyTA+8~ah)w*V+r-cTZ zi)1Fkj3_al?{o>c{^7qK(@Jtl4TR-u4R95^(xVgv-3C85ODmXl zL(&p@WqN>VP+Yee2a}eYszo)!oHGg69aWyBVeQ^SV_&fN@|tw1gRo6jt0J&6b*%ZT zdzRB%cb zYZ9RW_CtpqW-5RY!4UX{P(>n@wyYww*X8R#$SA6c(zathrsjJ6h6elKVY+^S@ItZ! zP~nS=DYu7o^v-FvCwcEWfEaO70)@p@hOFp2>e>AoNC~F?gfLDz3MnlL{6HQPBDooD zzt^9himdsiu<~UlIm|7Hz=Rj`hz44l6%jf~6_PV#1iJYyfuxAjwJn`}F8g5th#q|o zMN5=UZw`TYQ5Gt5E<`l1_EADt5s#2++OkEyG2oAqa~R*3U| zVa1r*b_n$2IX+tfQMrFRwH(z>I7XVIN7@pl-tf;Y0bIHNpK!$+&7L2c<1rGhJy zbSprT24D(R&CbW3z8n=f!lcjnE&SAdKejD2(F5xPMW!bxaj{NHa1GHF*hQ}s67vm2 z^Yc6bv8b5ryA$bn^#HOn1Zh`}608}pU+ul&!{9};*Gh{3b;1@6J#lq;l1M-X-28)s zGc=VjQFCIXuoZ=!-IU}M;P|7Hp*F?WH@){^{j_Y77|bNksmkg!2_-A;*uM9p$YiWY zY_u*~(k2#HtG1ivyV`U%?0g%1=bK2_wUGwaU@WuQh7cR3YQTckL^Oh=<_Qcapd zP!2hh@~!H~0mgcG$!TD(=I z#_FTm&)V<;#`kEZS8Hl_ll;H$SBU*mL0G^9@V(9{+fw_o?!;@L$$Ftf`us`Z>wOll zAJgmwW;P(&t%8`5=+1x&$YKx(UIBV}O%BGtd=|al11Cr&$<0c%$*{u#v;W21kxmpO I8Mo8FfaZ6$ng9R* literal 0 HcmV?d00001 diff --git a/docs/CONDUCT.html b/docs/CONDUCT.html index 2f90a1a2..95f45336 100644 --- a/docs/CONDUCT.html +++ b/docs/CONDUCT.html @@ -1,145 +1,60 @@ - - - - - - - -Contributor Code of Conduct • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Contributor Code of Conduct

+
+

Contributor Code of Conduct

+ Source: CONDUCT.md
@@ -149,73 +64,56 @@

Contributor Code of Conduct

Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.

Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.

-

This Code of Conduct is adapted from the Contributor Covenant (http:contributor-covenant.org), version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/

-
- -
- - - +

This Code of Conduct is adapted from the Contributor Covenant (http:contributor-covenant.org), version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/

+
-
+ - - + + diff --git a/docs/LICENSE-text.html b/docs/LICENSE-text.html index 5393e5b2..2c023e23 100644 --- a/docs/LICENSE-text.html +++ b/docs/LICENSE-text.html @@ -1,215 +1,113 @@ - - - - - - - -License • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

License

+
+

License

+ 
YEAR: 2016
 COPYRIGHT HOLDER: Robin Lovelace and Richard Ellison
-
- - - -
- +
-
+ - - + + diff --git a/docs/articles/index.html b/docs/articles/index.html index ff6b0e43..ab831dd1 100644 --- a/docs/articles/index.html +++ b/docs/articles/index.html @@ -1,222 +1,125 @@ - - - - - - - -Articles • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Articles

+
+

Articles

All vignettes

-
-
Origin-destination data with stplanr
-
-
stplanr: A Package for Transport Planning
-
-
Parallel routing and performance with stplanr
-
-
Route networks with stplanr
-
-
Transport routing with stplanr
-
-
Introducing stplanr
-
-
-
-
-
- - -
+ + + -
- + + - - + + diff --git a/docs/articles/stplanr-paper.html b/docs/articles/stplanr-paper.html index 86c3e77e..0323563a 100644 --- a/docs/articles/stplanr-paper.html +++ b/docs/articles/stplanr-paper.html @@ -4,266 +4,559 @@ - + + stplanr: A Package for Transport Planning • stplanr - + - - - - - - - + + + + + - - + + - -
-
-
-
-
-

stplanr: A Package for Transport Planning

-

Robin Lovelace

+ + +
+
+

stplanr: A Package for Transport Planning

+

Robin +Lovelace

- University of Leeds
+ University of +Leeds
-

Richard Ellison

+

Richard +Ellison

- University of Sydney
+ University of +Sydney
- Source: ../../vignettes/stplanr-paper.Rmd - - + Source: vignettes/stplanr-paper.Rmd +
stplanr-paper.Rmd

Abstract

-

Tools for transport planning should be flexible, scalable and transparent. The stplanr package demonstrates and provides a home for such tools, with an emphasis on spatial transport data and non-motorized modes. stplanr facilitates common transport planning tasks including: downloading and cleaning transport datasets; creating geographic ‘desire lines from origin-destination (OD) data; route assignment, via the SpatialLinesNetwork class and interfaces to routing services such as CycleStreets.net; calculation of route segment attributes such as bearing and aggregate flow; and `travel watershed’ analysis. This paper demonstrates this functionality using reproducible examples on real transport datasets. More broadly, the experience shows open source software can form the basis of a reproducible transport planning workflow. stplanr, alongside other packages and open source projects, could provide a more transparent and democratically accountable alternative to the current approach which is heavily reliant on proprietary and technically and financially inaccessible software.

+

Tools for transport planning should be flexible, scalable and + transparent. The stplanr package demonstrates and + provides a home for such tools, with an emphasis on spatial + transport data and non-motorized modes. stplanr + facilitates common transport planning tasks including: downloading + and cleaning transport datasets; creating geographic ‘desire lines + from origin-destination (OD) data; route assignment, via the + SpatialLinesNetwork class and interfaces to routing + services such as CycleStreets.net; calculation of route segment + attributes such as bearing and aggregate flow; and `travel + watershed’ analysis. This paper demonstrates this functionality + using reproducible examples on real transport datasets. More + broadly, the experience shows open source software can form the + basis of a reproducible transport planning workflow. + stplanr, alongside other packages and open source + projects, could provide a more transparent and democratically + accountable alternative to the current approach which is heavily + reliant on proprietary and technically and financially + inaccessible software.

-
-

-Note

-

This paper has now been peer reviewed and published by the R Journal. Please see the published version at journal.r-project.org and cite it as Lovelace and Ellison (2018).

-
-
-

-Introduction

-

Transport planning can broadly be defined as the process of designing and evaluating transport interventions (de Dios Ortuzar and Willumsen 2011) usually with the ultimate aim of improving transport systems from economic, social and environmental perspectives. This inevitably involves a degree of subjective judgment and intuition. With the proliferation of new transport datasets — and the increasing availability of hardware and software to make sense of them — there is great potential for the discipline to become more evidence-based and scientific (Balmer, Rieser, and Nagel 2009). Transport planners have always undertaken a wide range computational activities (Boyce and Williams 2015), but with the digital revolution the demands have grown beyond the capabilities of a single, monolithic product. The diversity of tasks , and need for democratic accountability in public decision making, suggests that future-proof transport planning software should be:

+
+

Note +

+

This paper has now been peer reviewed and published by the R Journal. +Please see the published version at journal.r-project.org +and cite it as Lovelace and Ellison +(2018).

+

The code presented in this paper requires stplanr 0.8.5 or earlier, +which can be installed as follows:

+
+remotes::install_github("ropensci/stplanr", ref = "v0.8.5")
+
+
+

Introduction +

+

Transport planning can broadly be defined as the process of designing +and evaluating transport interventions (de Dios +Ortuzar and Willumsen 2011) usually with the ultimate aim of +improving transport systems from economic, social and environmental +perspectives. This inevitably involves a degree of subjective judgment +and intuition. With the proliferation of new transport datasets — and +the increasing availability of hardware and software to make sense of +them — there is great potential for the discipline to become more +evidence-based and scientific (Balmer, Rieser, +and Nagel 2009). Transport planners have always undertaken a wide +range computational activities (Boyce and +Williams 2015), but with the digital revolution the demands have +grown beyond the capabilities of a single, monolithic product. The +diversity of tasks , and need for democratic accountability in public +decision making, suggests that future-proof transport planning software +should be:

  • flexible, able to handle a wide range of data formats

    • -

  • scalable, able to work at multiple geographic levels from single streets to large cities and regions

    • -

  • robust and reliable, tested on a range of datasets and able to work ’out of the box’ in a range of real-world projects

    • -

  • open source and reproducible, ensuring transparency and encouraging citizen science

    • +

  • scalable, able to work at multiple geographic levels from single +streets to large cities and regions

    • +

  • robust and reliable, tested on a range of datasets and able to +work ’out of the box’ in a range of real-world projects

    • +

  • open source and reproducible, ensuring transparency and +encouraging citizen science

-

This paper sets out to demonstrate that open source software with a command-line interface (CLI) can provide a foundation for transport planning software that meets each of these criteria. R provides a strong basis for progress in this direction because it already contains functionality used in common transport planning workflows. , and greatly improved R’s spatial abilities (Bivand, Pebesma, and G’omez-Rubio 2013), work that is being consolidated and extended in the recent package.

-

Building on these foundations a number of spatial packages have been developed for applied domains including: disease mapping and modelling, with packages such as and (Kim and Wakefield 2016; Brown and Zhou 2016); spatial ecology, with the adehabitat family of packages (Calenge 2006); and visualisation, with packages such as SpatialEpi, diseasemapping and Brown (2016). However, there has been little prior work to develop R functionality designed specifically for transport planning, with the notable exceptions of TravelR (a package on R-Forge last updated in 2012) and gtfsr (a package for handling General Transit Feed Specification (GTFS) data).

-

The purpose of stplanr is to provide a toolbox rather than a specific solution for transport planning, with an emphasis on spatial data and active modes. This emphasis is timely given the recent emphasis on sustainability (Banister 2008) and ‘Big Data’ (Zheng et al. 2016) in the wider field of transport planning. A major motivation was the lack of R packages, and open source software in general, for transport applications. This may be surprising given the uqiquity of transport problems;1 R’s proficiency at handling spatial, temporal and travel survey data that describe transport systems; and the growing popularity of R in applied domains (Jalal et al. 2017; Moore and Hutchinson 2017). Another motivation is the growth in open access datasets: the main purpose of early versions of the package was to process open origin-destination data (Lovelace et al. 2017).

-

R is already used in transport applications, as illustrated by recent research that applies packages from other domains to transport problems. For instance, Efthymiou and Antoniou (2012) use R to analyse the data collected from an online survey focused on car-sharing, bicycle-sharing and electric vehicles. Efthymiou and Antoniou (2012) also used R to collect and analyse transport-related data from Twitter using packages including , and . These packages were used to download, parse and plot the Twitter data using a method that can be repeated and the results reproduced or updated. More general statistical analyses have also been conducted on transport-related datasets using packages including and (Diana 2012; Cerin et al. 2013). Despite the rising use of R for transport research, there has yet been to be a package for transport planning.

-

The design of the R language, with its emphasis on flexibility, data processing and statistical modelling, suggests it can provide a powerful environment for transport planning research. There are many quantitative methods in transport planning, many of which fit into the classic ‘four stage’ transport model which involves the following steps (de Dios Ortuzar and Willumsen 2011): (1) trip generation to estimate trip freqency from origins; (2) distribution of trips to destinations; (3) modal split of trips between walking, cycling, buses etc.; (4) assignment of trips to the transport route network. To this we would like to add two more stages for the big data age: (0) data processing and exploration; and (5) validation. This sequence is not the only way of transport modelling and some have argued that its dominance has reduced innovation. However it is certainly a common approach and provides a useful schema for classifying the kinds of task that stplanr can tackle:

+

This paper sets out to demonstrate that open source software with a +command-line interface (CLI) can provide a foundation for transport +planning software that meets each of these criteria. R provides a strong +basis for progress in this direction because it already contains +functionality used in common transport planning workflows. , and greatly +improved R’s spatial abilities (Bivand, Pebesma, +and G’omez-Rubio 2013), work that is being consolidated and +extended in the recent package.

+

Building on these foundations a number of spatial packages have been +developed for applied domains including: disease mapping and modelling, +with packages such as and (Kim and Wakefield +2016; Brown and Zhou 2016); spatial ecology, with the +adehabitat family of packages (Calenge 2006); and visualisation, with packages +such as SpatialEpi, diseasemapping and +Brown (2016). However, there has been +little prior work to develop R functionality designed specifically for +transport planning, with the notable exceptions of TravelR (a +package on R-Forge last updated in 2012) and tidytransit (a +package for handling General Transit Feed Specification (GTFS) +data).

+

The purpose of stplanr is to provide a toolbox +rather than a specific solution for transport planning, with an emphasis +on spatial data and active modes. This emphasis is timely given the +recent emphasis on sustainability (Banister +2008) and ‘Big Data’ (Zheng et al. +2016) in the wider field of transport planning. A major +motivation was the lack of R packages, and open source software in +general, for transport applications. This may be surprising given the +ubiquity of transport problems;1 R’s proficiency at handling spatial, +temporal and travel survey data that describe transport systems; and the +growing popularity of R in applied domains (Jalal +et al. 2017; Moore and Hutchinson 2017). Another motivation is +the growth in open access datasets: the main purpose of early versions +of the package was to process open origin-destination data (Lovelace et al. 2017).

+

R is already used in transport applications, as illustrated by recent +research that applies packages from other domains to transport problems. +For instance, Efthymiou and Antoniou +(2012) use R to analyse the data collected from an online survey +focused on car-sharing, bicycle-sharing and electric vehicles. Efthymiou and Antoniou (2012) also used R to +collect and analyse transport-related data from Twitter using packages +including , and . These packages were used to download, parse and plot +the Twitter data using a method that can be repeated and the results +reproduced or updated. More general statistical analyses have also been +conducted on transport-related datasets using packages including and +(Diana 2012; Cerin et al. 2013). Despite +the rising use of R for transport research, there has yet been to be a +package for transport planning.

+

The design of the R language, with its emphasis on flexibility, data +processing and statistical modelling, suggests it can provide a powerful +environment for transport planning research. There are many quantitative +methods in transport planning, many of which fit into the classic ‘four +stage’ transport model which involves the following steps (de Dios Ortuzar and Willumsen 2011): (1) trip +generation to estimate trip freqency from origins; (2) +distribution of trips to destinations; (3) modal split +of trips between walking, cycling, buses etc.; (4) assignment +of trips to the transport route network. To this we would like to add +two more stages for the big data age: (0) data processing and +exploration; and (5) validation. This sequence is not the only way of +transport modelling and some have argued that its dominance has reduced +innovation. However it is certainly a common approach and provides a +useful schema for classifying the kinds of task that +stplanr can tackle:

    -

  • Accessing and processing of data on transport infrastructure and behaviour (stage 0)

    • +

  • Accessing and processing of data on transport infrastructure and +behaviour (stage 0)

  • Analysis and visualisation of the transport network (0)

    • -

  • Analysis of origin-destination (OD) data and the visualisation of resulting ‘desire lines’

    • -

  • The allocation of desire lines to roads and other guideways via routing services

    • -

  • The aggregation of routes to estimate total levels of flow on segments throughout the transport network

    • -

  • Development of models to estimate transport behaviour currently and under various scenarios of change

    • -

  • The calculation of ‘catchment areas’ affected by transport infrastructure

    • +

  • Analysis of origin-destination (OD) data and the visualisation of +resulting ‘desire lines’

    • +

  • The allocation of desire lines to roads and other guideways via +routing services

    • +

  • The aggregation of routes to estimate total levels of flow on +segments throughout the transport network

    • +

  • Development of models to estimate transport behaviour currently +and under various scenarios of change

    • +

  • The calculation of ‘catchment areas’ affected by transport +infrastructure

-

The automation of such tasks can assist researchers and practitioners to create evidence for decision making. If the data processing and analysis stages are fast and painless, more time can be dedicated to visualisation and decision making. This should allow researchers to focus on problems, rather than on clunky graphical user interfaces (GUIs), and ad-hoc scripts that could be generalised. Furthermore, if the process can be made reproducible and accessible (e.g. via online visualisation packages such as shiny), this could help transport planning move away from reliance on ‘black boxes’ (Waddell 2002) and empower citizens to challenge decisions made by transport planning authorities based on the evidence (Hollander 2016). There are many advantages of using a scriptable, interactive and open source language such as R for transport planning. Such an approach enables: reproducible research; the automation and sharing of code between researchers; reduced barriers to innovation as anyone can create new features for the benefit of all planners; easier interaction with non domain experts (who will lack dedicated software); and integration with other software systems, as illustrated by the use of to generate JavaScript for sharing interactive maps for transport planning, as used in the publicly accessible Propensity to Cycle Tool (Lovelace et al. 2017). Furthermore, R has a strong user community which can support newcomers (stplanr was peer reviewed thanks to the community surrounding ROpenSci). The advantages of using R specifically to develop the functionality described in this paper are that it has excellent geo-statistical capabilities (Pebesma et al. 2015), visualisation packages (e.g. tmap, ggplot2), support for logit models (which are useful for modelling modal shift), and support for the many formats that transport datasets are stored in (e.g. via the haven and rio packages).

+

The automation of such tasks can assist researchers and practitioners +to create evidence for decision making. If the data processing and +analysis stages are fast and painless, more time can be dedicated to +visualisation and decision making. This should allow researchers to +focus on problems, rather than on clunky graphical user interfaces +(GUIs), and ad-hoc scripts that could be generalised. Furthermore, if +the process can be made reproducible and accessible (e.g. via online +visualisation packages such as shiny), this could help +transport planning move away from reliance on ‘black boxes’ (Waddell 2002) and empower citizens to challenge +decisions made by transport planning authorities based on the evidence +(Hollander 2016). There are many +advantages of using a scriptable, interactive and open source language +such as R for transport planning. Such an approach enables: reproducible +research; the automation and sharing of code between researchers; +reduced barriers to innovation as anyone can create new features for the +benefit of all planners; easier interaction with non domain experts (who +will lack dedicated software); and integration with other software +systems, as illustrated by the use of to generate JavaScript for sharing +interactive maps for transport planning, as used in the publicly +accessible Propensity to Cycle Tool (Lovelace et +al. 2017). Furthermore, R has a strong user community which can +support newcomers (stplanr was peer reviewed thanks to the +community surrounding ROpenSci). The advantages of using R specifically +to develop the functionality described in this paper are that it has +excellent geo-statistical capabilities (Pebesma +et al. 2015), visualisation packages (e.g. tmap, +ggplot2), support for logit models (which are useful +for modelling modal shift), and support for the many formats that +transport datasets are stored in (e.g. via the haven +and rio packages).

-
-

-Package structure and functionality

-

The package can be installed and loaded in the usual way (see the package’s README for dependencies and access to development versions):

-
-install.packages("stplanr")
+
+

Package structure and functionality +

+

The package can be installed and loaded in the usual way (see the +package’s README for +dependencies and access to development versions):

-

As illustrated by the message emitted when stplanr is loaded, it depends on . This means that the spatial data classes commonly used in the package will work with generic R functions such as summary, aggregate and, as illustrated in the figures below, plot .

-
-

-Core functions and classes

-

The package’s core functions are structured around 3 common types of spatial transport data:

+install.packages("stplanr")
+ +

As illustrated by the message emitted when stplanr +is loaded, it depends on . This means that the spatial data classes +commonly used in the package will work with generic R functions such as +summary, aggregate and, as illustrated in the +figures below, plot .

+
+

Core functions and classes +

+

The package’s core functions are structured around 3 common types of +spatial transport data:

    -
  • Origin-destination (OD) data, which report the number of people travelling between origin-destination pairs. This type of data is not explicitly spatial (OD datasets are usually represented as data frames) but represents movement over space between points in geographical space. An example is provided in the flow dataset.
    • -
  • Line data, one dimensional linear features on the surface of the Earth. These are typically stored as a SpatialLinesDataFrame.
    • -
  • Route data are special types of lines which have been allocated to the transport network. Routes typically result from the allocation of a straight ‘desire line’ allocated to the route network with a route_ function. Route network represent many overlapping routes. All are typically stored as SpatialLinesDataFrame.
    • +
  • Origin-destination (OD) data, which report the number of people +travelling between origin-destination pairs. This type of data is not +explicitly spatial (OD datasets are usually represented as data frames) +but represents movement over space between points in geographical space. +An example is provided in the flow dataset.
    • +
  • Line data, one dimensional linear features on the surface of the +Earth. These are typically stored as a +SpatialLinesDataFrame.
    • +
  • Route data are special types of lines which have been allocated to +the transport network. Routes typically result from the allocation of a +straight ‘desire line’ allocated to the route network with a +route_ function. Route network represent many overlapping +routes. All are typically stored as +SpatialLinesDataFrame.
-

For ease of use, functions focussed on each data type have been developed with names prefixed with od_, line_ and route_ respectively. A selection of these is presented in Table 1. Additional ‘core functions’ could be developed, such as those prefixed with rn_ (for working with route network data) and g_ functions for geographic operations such as buffer creation on lat/lon projected data (this function is currently named buff_geo). We plan to elicit feedback on such changes before implementing them.

-

With a tip of the hat to the concept of type stability (e.g. as implemented in ), we also plan to make the core functions of stplanr more type-stable in future releases. Core functions, which begin with the prefixes listed above, could follow ’s lead and return only objects with the same class as that of the input. However there are limitations to this approach: it will break existing functionality and mean that output objects have a larger size than necessary (line_bearing, for example, does not need to duplicate the spatial data contained in its input). Instead, we plan to continue to name functions around the type of input data they take, but are open minded about function input-output data class conventions, especially in the context of the new class system implemented in .

-

A class system has not been developed for each data type (this option is discussed in the final section). The most common data types used in stplanr are assumed to be data frames and spatial datasets.

-

Transport datasets are very diverse. There are therefore many other functions which have more ad-hock names. Rather attempt a systematic description of each of stplanr’s functions (which can be gleaned from the online manual) it is more illuminating to see how they work together, as part of a transport planning workflow. As with most workflows, this begins with data access and ends with visualisation.

-
-
-

-Accessing and processing transport data

-

Gaining access to data is often the first stage in transport research. This is often a long and protracted process which is thankfully becoming easier thanks to the ‘open data’ movement and packages such as tigris for making data access from within R easier .

-

stplanr provides a variety of different functions that facilitate importing common data formats used for transport analysis into R. Although transport analysis generally requires some transport-specific datasets, it also typically relies heavily on common sources of data including census data. This being the case, stplanr also includes functions that may be useful to those not involved in transport research. This includes the read_table_builder function for importing data from the Australian Bureau of Statistics (ABS) and the UK’s Stats19 road traffic casualty dataset. A brief example of the latter is demonstrated below, which begins with downloading the data (warning this downloads ~100 MB of data):

-
-dl_stats19() # download and extract stats19 road traffic casualty data
-
#> [1] "Data saved at: /tmp/RtmpppF3E2/Accidents0514.csv"
-#> [2] "Data saved at: /tmp/RtmpppF3E2/Casualties0514.csv"
-#> [3] "Data saved at: /tmp/RtmpppF3E2/Vehicles0514.csv"
-

Once the data has been saved in the default directory, determined by tempdir(), it can be read-in and cleaned with the read_stats19_ functions (note these call format_stats19_ functions internally to clean the datasets and add correct labels to the variables):

-
-ac <- read_stats19_ac()
-ca <- read_stats19_ca()
-ve <- read_stats19_ve()
-

The resulting datasets (representing accident, casualty and vehicle level data, respectively) can be merged and made geographic, as illustrated below:

+

For ease of use, functions focussed on each data type have been +developed with names prefixed with od_, line_ +and route_ respectively. A selection of these is presented +in Table 1. Additional ‘core functions’ could be developed, such as +those prefixed with rn_ (for working with route network +data) and g_ functions for geographic operations such as +buffer creation on lat/lon projected data (this function is currently +named buff_geo). We plan to elicit feedback on such changes +before implementing them.

+

With a tip of the hat to the concept of type stability (e.g. as +implemented in ), we also plan to make the core functions of +stplanr more type-stable in future releases. Core +functions, which begin with the prefixes listed above, could follow ’s +lead and return only objects with the same class as that of the input. +However there are limitations to this approach: it will break existing +functionality and mean that output objects have a larger size than +necessary (line_bearing, for example, does not need to +duplicate the spatial data contained in its input). Instead, we plan to +continue to name functions around the type of input data they +take, but are open minded about function input-output data class +conventions, especially in the context of the new class system +implemented in .

+

A class system has not been developed for each data type (this option +is discussed in the final section). The most common data types used in +stplanr are assumed to be data frames and spatial +datasets.

+

Transport datasets are very diverse. There are therefore many other +functions which have more ad-hock names. Rather attempt a systematic +description of each of stplanr’s functions (which can +be gleaned from the online manual) it is more illuminating to see how +they work together, as part of a transport planning workflow. As with +most workflows, this begins with data access and ends with +visualisation.

+
+
+

Accessing and processing transport data +

+

Gaining access to data is often the first stage in transport +research. This is often a long and protracted process which is +thankfully becoming easier thanks to the ‘open data’ movement and +packages such as tigris for making data access from +within R easier .

+

stplanr provides a variety of different functions +that facilitate importing common data formats used for transport +analysis into R. Although transport analysis generally requires some +transport-specific datasets, it also typically relies heavily on common +sources of data including census data. This being the case, +stplanr also includes functions that may be useful to +those not involved in transport research. This includes the +read_table_builder function for importing data from the +Australian Bureau of Statistics (ABS) and the UK’s Stats19 road traffic +casualty dataset. A brief example of the latter is demonstrated below, +which begins with downloading the data (warning this downloads ~100 MB +of data):

+
+dl_stats19() # download and extract stats19 road traffic casualty data
+
#> [1] "Data saved at: /tmp/RtmpppF3E2/Accidents0514.csv"
+#> [2] "Data saved at: /tmp/RtmpppF3E2/Casualties0514.csv"
+#> [3] "Data saved at: /tmp/RtmpppF3E2/Vehicles0514.csv"
+

Once the data has been saved in the default directory, determined by +tempdir(), it can be read-in and cleaned with the +read_stats19_ functions (note these call +format_stats19_ functions internally to clean the datasets +and add correct labels to the variables):

-library(dplyr)
-ca_ac <- inner_join(ca, ac)
-ca_cycle <- ca_ac %>%
-  filter(Casualty_Severity == "Fatal" & !is.na(Latitude)) %>%
-  select(Age = Age_of_Casualty, Mode = Casualty_Type, Longitude, Latitude)
-ca_sp <- SpatialPointsDataFrame(coords = ca_cycle[3:4], data = ca_cycle[1:2])
-

Now that this casualty data has been cleaned, subsetted (to only include serious cycle crashes) and converted into a spatial class system, we can analyse them using geographical datasets of the type commonly used by stplanr. The following code, for example, geographically subsets the dataset to include only crashes that occured within the bounding box of a route network dataset provided by stplanr (from version 0.1.7 and beyond) using the function bb2poly, which converts a spatial dataset into a box, represented as a rectangular SpatialPolygonsDataFrame:

+ac <- read_stats19_ac() +ca <- read_stats19_ca() +ve <- read_stats19_ve()
+

The resulting datasets (representing accident, casualty and vehicle +level data, respectively) can be merged and made geographic, as +illustrated below:

-data("route_network") # devtools::install_github("ropensci/splanr")version 0.1.7
-proj4string(ca_sp) <- proj4string(route_network)
-bb <- bb2poly(route_network)
-proj4string(bb) <- proj4string(route_network)
-ca_local <- ca_sp[bb, ]
-

The above code chunk shows the importance of understanding geographical data when working with transport data. It is only by converting the casualty data into a spatial data class, and adding a coordinate reference system (CRS), that transport planners and researchers can link this important dataset back to the route network. We can now perform GIS operations on the results. The next code chunk, for example, finds all the fatalities that took place within 100 m of the route network, using the function buff_geo:

+library(dplyr) +ca_ac <- inner_join(ca, ac) +ca_cycle <- ca_ac %>% + filter(Casualty_Severity == "Fatal" & !is.na(Latitude)) %>% + select(Age = Age_of_Casualty, Mode = Casualty_Type, Longitude, Latitude) +ca_sp <- SpatialPointsDataFrame(coords = ca_cycle[3:4], data = ca_cycle[1:2])
+

Now that this casualty data has been cleaned, subsetted (to only +include serious cycle crashes) and converted into a spatial class +system, we can analyse them using geographical datasets of the type +commonly used by stplanr. The following code, for +example, geographically subsets the dataset to include only crashes that +occured within the bounding box of a route network dataset provided by +stplanr (from version 0.1.7 and beyond) using the +function bb2poly, which converts a spatial dataset into a +box, represented as a rectangular +SpatialPolygonsDataFrame:

-rnet_buff_100 <- geo_buffer(route_network, width = 100)
-ca_buff <- ca_local[rnet_buff_100, ]
-

These can be visualised using base R graphics, extended by , as illustrated in Figure . This provides a good start for analysis but for publication-quality plots and interactive plots, designed for public engagement, we recommend using dedicated visualisation packages that work with spatial data such as .

+data("route_network") # devtools::install_github("ropensci/splanr")version 0.1.7 +proj4string(ca_sp) <- proj4string(route_network) +bb <- bb2poly(route_network) +proj4string(bb) <- proj4string(route_network) +ca_local <- ca_sp[bb, ]
+

The above code chunk shows the importance of understanding +geographical data when working with transport data. It is only by +converting the casualty data into a spatial data class, and adding a +coordinate reference system (CRS), that transport planners and +researchers can link this important dataset back to the route network. +We can now perform GIS operations on the results. The next code chunk, +for example, finds all the fatalities that took place within 100 m of +the route network, using the function buff_geo:

-plot(bb, lty = 4)
-plot(rnet_buff_100, col = "grey", add = TRUE)
-points(ca_local, pch = 4)
-points(ca_buff, cex = 3)
-
-
-

-Creating geographic desire lines

-

Perhaps the most common type of aggregate-level transport information is origin-destination (‘OD’) data. This can be presented either as a matrix or (more commonly) a long table of OD pairs. An example of this type of raw data is provided below (see ?flow to see how this dataset was created).

+rnet_buff_100 <- geo_buffer(route_network, width = 100) +ca_buff <- ca_local[rnet_buff_100, ]
+

These can be visualised using base R graphics, extended by , as +illustrated in Figure \(\ref{fig:fats}\). This provides a good +start for analysis but for publication-quality plots and interactive +plots, designed for public engagement, we recommend using dedicated +visualisation packages that work with spatial data such as .

-data("flow", package = "stplanr")
-head(flow[c(1:3, 12)])
-

Although the flow data displayed above describes movement over geographical space, it contains no explicitly geographical information. Instead, the coordinates of the origins and destinations are linked to a separate geographical dataset which also must be loaded to analyse the flows. This is a common problem solved by the function od2line. The geographical data is a set of points representing centroids of the origin and destinations, saved as a SpatialPointsDataFrame. Geographical data in R is best represented as such Spatial* objects, which use the S4 object engine. This explains the close integration of stplanr with R’s spatial packages, especially sp, which defines the S4 spatial object system.

+plot(bb, lty = 4) +plot(rnet_buff_100, col = "grey", add = TRUE) +points(ca_local, pch = 4) +points(ca_buff, cex = 3)
+
+
+

Creating geographic desire lines +

+

Perhaps the most common type of aggregate-level transport information +is origin-destination (‘OD’) data. This can be presented either as a +matrix or (more commonly) a long table of OD pairs. An example of this +type of raw data is provided below (see ?flow to see how +this dataset was created).

-data("cents", package = "stplanr")
-as.data.frame(cents[1:3, -c(3, 4)])
-

We use od2line to combine flow and cents, to join the former to the latter. We will visualise the l object created below in the next section.

+data("flow", package = "stplanr") +head(flow[c(1:3, 12)])
+

Although the flow data displayed above describes movement over +geographical space, it contains no explicitly geographical information. +Instead, the coordinates of the origins and destinations are linked to a +separate geographical dataset which also must be loaded to analyse the +flows. This is a common problem solved by the function +od2line. The geographical data is a set of points +representing centroids of the origin and destinations, saved as a +SpatialPointsDataFrame. Geographical data in R is best +represented as such Spatial* objects, which use the +S4 object engine. This explains the close integration of +stplanr with R’s spatial packages, especially +sp, which defines the S4 spatial object +system.

-l <- od2line(flow = flow, zones = cents)
-

The data is now in a form that is much easier to analyse. We can plot the data with the command plot(l), which was not possible before. Because the SpatialLinesDataFrame object also contains data per line, it also helps with visualisation of the flows, as illustrated in Figure .

-
-
-

-Allocating flows to the transport network

-

A common problem faced by transport researchers is network allocation: converting the ‘as the crow flies’ lines illustrated in the figure above into routes. These are the complex, winding paths that people and animals make to avoid obstacles such as buildings and to make the journey faster and more efficient (e.g. by following the route network).

-

This is difficult (and was until recently near impossible using free software) because of the size and complexity of transport networks, the complexity of realistic routing algorithms and need for context-specificity in the routing engine. Inexperienced cyclists, for example, would take a very different route than a heavy goods vehicle. stplanr tackles this issue by using 3rd party APIs to provide route-allocation.

-

Route allocation is undertaken by functions such as and . These allocate a single OD pair, represented as a text string to be ‘geo-coded,’ a pair of of coordinates, or two SpatialPoints objects, representing origins and destinations. This is illustrated below with route_cyclestreet, which uses the CycleStreets.net API, a routing service “by cyclists for cyclists” that offers a range route strategies (primarily ‘fastest,’ ‘quietest’ and ‘balanced’) that are based on a detailed analysis of cyclist wayfinding:2

+data("cents", package = "stplanr") +as.data.frame(cents[1:3, -c(3, 4)])
+

We use od2line to combine flow and +cents, to join the former to the latter. We will visualise +the l object created below in the next section.

-route_bl <- route_cyclestreets(from = "Bradford", to = "Leeds")
-route_c1_c2 <- route_cyclestreets(cents[1, ], cents[2, ])
-

The raw output from routing APIs is usually provided as a JSON or GeoJSON text string. By default, route_cyclestreet saves a number of key variables (including length, time, hilliness and busyness variables generated by CycleStreets.net) from the attribute data provided by the API. If the user wants to save the raw output, the save_raw argument can be used:

+l <- od2line(flow = flow, zones = cents)
+

The data is now in a form that is much easier to analyse. We can plot +the data with the command plot(l), which was not possible +before. Because the SpatialLinesDataFrame object also +contains data per line, it also helps with visualisation of the flows, +as illustrated in Figure \(\ref{fig:lines_routes}\).

+
+
+

Allocating flows to the transport network +

+

A common problem faced by transport researchers is network +allocation: converting the ‘as the crow flies’ lines illustrated in the +figure above into routes. These are the complex, winding paths that +people and animals make to avoid obstacles such as buildings and to make +the journey faster and more efficient (e.g. by following the route +network).

+

This is difficult (and was until recently near impossible using free +software) because of the size and complexity of transport networks, the +complexity of realistic routing algorithms and need for +context-specificity in the routing engine. Inexperienced cyclists, for +example, would take a very different route than a heavy goods vehicle. +stplanr tackles this issue by using 3rd party APIs to +provide route-allocation.

+

Route allocation is undertaken by functions such as and . These +allocate a single OD pair, represented as a text string to be +‘geo-coded’, a pair of of coordinates, or two SpatialPoints +objects, representing origins and destinations. This is illustrated +below with route_cyclestreet, which uses the CycleStreets.net API, a +routing service “by cyclists for cyclists” that offers a range route +strategies (primarily ‘fastest’, ‘quietest’ and ‘balanced’) that are +based on a detailed analysis of cyclist wayfinding:2

-route_bl_raw <- route_cyclestreets(from = "Bradford", to = "Leeds", save_raw = TRUE)
-

Additional arguments taken by the route_ functions depend on the routing function in question. By changing the plan argument of route_cyclestreet to fastest, quietest or balanced, for example, routes favouring speed, quietness or a balance between speed and quietness will be saved, respectively.

-

To automate the creation of route-allocated lines over many desire lines, the line2route function loops over each line, wrapping any route_ function as an input. The output is a SpatialLinesDataFrame with the same number of dimensions as the input dataset (see the right panel in Figure ).

-
routes_fast <- line2route(l = l, route_fun = route_cyclestreet)
-

The result of this ‘batch routing’ exercise is illustrated in Figure . The red lines in the left hand panel are very different from the hypothetical straight ‘desire lines’ often used in transport research, highlighting the importance of this route-allocation functionality.

-
-plot(route_network, lwd = 0)
-plot(l, lwd = l$All / 10, add = TRUE)
-lines(routes_fast, col = "red")
-routes_fast$All <- l$All
-rnet <- overline(routes_fast, "All", fun = sum)
-rnet$flow <- rnet$All / mean(rnet$All) * 3
-plot(rnet, lwd = rnet$flow / mean(rnet$flow))
-

To estimate the amount of capacity needed at each segment on the transport network, the overline function demonstrated above, is used to divide line geometries into unique segments and aggregate the overlapping values. The results, illustrated in the right-hand panel of Figure , can be used to estimate where there is most need to improve the transport network, for example informing the decision of where to build new bicycle paths.

-

Limitations with the route_cyclestreet routing API include its specificity, to one mode (cycling) and a single region (the UK and part of Europe). To overcome these limitations, additional routing APIs were added with the functions route_graphhopper, route_transportapi_public and viaroute. These interface to Graphhopper, TransportAPI and the Open Source Routing Machine (OSRM) routing services, respectively. The great advantage of OSRM is that it allows you to run your own routing services on a local server, greatly increasing the rate of route generation.

-

A short example of finding the route by car and bike between New York and Oaxaca demonstrates how route_graphhopper can collect geographical and other data on routes by various modes, anywhere in the world. The output, shown in Table , shows that the function also saves time, distance and (for bike trips) vertical distance climbed for the trips.

+route_bl <- route_cyclestreets(from = "Bradford", to = "Leeds") +route_c1_c2 <- route_cyclestreets(cents[1, ], cents[2, ])
+

The raw output from routing APIs is usually provided as a JSON or +GeoJSON text string. By default, route_cyclestreet saves a +number of key variables (including length, time, hilliness and busyness +variables generated by CycleStreets.net) from the attribute data +provided by the API. If the user wants to save the raw output, the +save_raw argument can be used:

+
+route_bl_raw <- route_cyclestreets(from = "Bradford", to = "Leeds", save_raw = TRUE)
+

Additional arguments taken by the route_ functions +depend on the routing function in question. By changing the +plan argument of route_cyclestreet to +fastest, quietest or balanced, +for example, routes favouring speed, quietness or a balance between +speed and quietness will be saved, respectively.

+

To automate the creation of route-allocated lines over many desire +lines, the line2route function loops over each line, +wrapping any route_ function as an input. The output is a +SpatialLinesDataFrame with the same number of dimensions as +the input dataset (see the right panel in Figure \(\ref{fig:lines_routes}\)).

+
routes_fast <- line2route(l = l, route_fun = route_cyclestreet)
+

The result of this ‘batch routing’ exercise is illustrated in Figure +\(\ref{fig:lines_routes}\). The red +lines in the left hand panel are very different from the hypothetical +straight ‘desire lines’ often used in transport research, highlighting +the importance of this route-allocation functionality.

-ny2oaxaca1 <- route_graphhopper("New York", "Oaxaca", vehicle = "bike")
-ny2oaxaca2 <- route_graphhopper("New York", "Oaxaca", vehicle = "car")
-rbind(ny2oaxaca1@data, ny2oaxaca2@data)
+plot(route_network, lwd = 0) +plot(l, lwd = l$All / 10, add = TRUE) +lines(routes_fast, col = "red") +routes_fast$All <- l$All +rnet <- overline(routes_fast, "All", fun = sum) +rnet$flow <- rnet$All / mean(rnet$All) * 3 +plot(rnet, lwd = rnet$flow / mean(rnet$flow)) +

To estimate the amount of capacity needed at each segment on the +transport network, the overline function demonstrated +above, is used to divide line geometries into unique segments and +aggregate the overlapping values. The results, illustrated in the +right-hand panel of Figure \(\ref{fig:lines_routes}\), can be used to +estimate where there is most need to improve the transport network, for +example informing the decision of where to build new bicycle paths.

+

Limitations with the route_cyclestreet routing API +include its specificity, to one mode (cycling) and a single region (the +UK and part of Europe). To overcome these limitations, additional +routing APIs were added with the functions +route_graphhopper, route_transportapi_public +and viaroute. These interface to Graphhopper, TransportAPI +and the Open Source Routing Machine (OSRM) routing services, +respectively. The great advantage of OSRM is that it allows you to run +your own routing services on a local server, greatly increasing the rate +of route generation.

+

A short example of finding the route by car and bike between New York +and Oaxaca demonstrates how route_graphhopper can collect +geographical and other data on routes by various modes, anywhere in the +world. The output, shown in Table \(\ref{tab:xtnyoa}\), shows that the function +also saves time, distance and (for bike trips) vertical distance climbed +for the trips.

+
+ny2oaxaca1 <- route_graphhopper("New York", "Oaxaca", vehicle = "bike")
+ny2oaxaca2 <- route_graphhopper("New York", "Oaxaca", vehicle = "car")
+rbind(ny2oaxaca1@data, ny2oaxaca2@data)
@@ -285,292 +578,528 @@

time
-
-

-Modelling travel catchment areas

-

Accessibility to transport services is a particularly important topic when considering public transport or active travel because of the frequent steep reduction in use as distances to access services (or infrastructure) increase. As a result, the planning for transport services and infrastructure frequently focuses on several measures of accessibility including distance, but also travel times and frequencies and weighted by population. The functions in stplanr are intended to provide a method of estimating these accessibility measures as well as calculating the population that can access specific services (i.e., estimating the catchment area).

-

Catchment areas in particular are a widely used measure of accessibility that attempts to both quantify the likely target group for a particular service, and visualise the geographic area that is covered by the service. For instance, passengers are often said to be willing to walk up to 400 metres to a bus stop, or 800 metres to a railway station . Although these distances may appear relatively arbitrary and have been found to underestimate the true catchment area of bus stops and railway stations they nonetheless represent a good, albeit somewhat conservative, starting point from which catchment areas can be determined.

-

In many cases, catchment areas are calculated on the basis of straight-line (or “as the crow flies”) distances. This is a simplistic, but relatively appealing approach because it requires little additional data and is straight-forward to understand. stplanr provides functionality that calculates catchment areas using straight-line distances with the calc_catchment function. This function takes a SpatialPolygonsDataFrame that contains the population (or other) data, typically from a census, and a Spatial* layer that contains the geometry of the transport facility. These two layers are overlayed to calculate statistics for the desired catchments including proportioning polygons to account for the proportion located within the catchment area.

-

To illustrate how catchment areas can be calculated, stplanr contains some sample datasets stored in ESRI Shapefile format (a commonly used format for distributing GIS layers) that can together be used to calculate sample catchment areas. One of these datasets (smallsa1) contains population data for Statistical Area 1 (SA1) zones in Sydney, Australia. The second contains hypothetical cycleways aligned to streets in Sydney. The code below unzips the datasets and reads in the shapefiles.

-
-data_dir <- system.file("extdata", package = "stplanr")
-unzip(file.path(data_dir, "smallsa1.zip"))
-unzip(file.path(data_dir, "testcycleway.zip"))
-sa1income <- as(sf::read_sf("smallsa1.shp"), "Spatial")
-testcycleway <- as(sf::read_sf("testcycleway.shp"), "Spatial")
-# Remove unzipped files
-file.remove(list.files(pattern = "^(smallsa1|testcycleway).*"))
-

Calculating the catchment area is straightforward and in addition to specifying the required datasets, only a vector containing column names to calculate statistics and a distance is required. Since proportioning the areas assumes projected data, unprojected data are automatically projected to either a common projection (if one is already projected) or a specified projection. It should be emphasised that the choice of projection is important and has an effect on the results meaning setting a local projection is recommended to achieve the most accurate results.

+
+

Modelling travel catchment areas +

+

Accessibility to transport services is a particularly important topic +when considering public transport or active travel because of the +frequent steep reduction in use as distances to access services (or +infrastructure) increase. As a result, the planning for transport +services and infrastructure frequently focuses on several measures of +accessibility including distance, but also travel times and frequencies +and weighted by population. The functions in stplanr +are intended to provide a method of estimating these accessibility +measures as well as calculating the population that can access specific +services (i.e., estimating the catchment area).

+

Catchment areas in particular are a widely used measure of +accessibility that attempts to both quantify the likely target group for +a particular service, and visualise the geographic area that is covered +by the service. For instance, passengers are often said to be willing to +walk up to 400 metres to a bus stop, or 800 metres to a railway station +. Although these distances may appear relatively arbitrary and have been +found to underestimate the true catchment area of bus stops and railway +stations they nonetheless represent a good, albeit somewhat +conservative, starting point from which catchment areas can be +determined.

+

In many cases, catchment areas are calculated on the basis of +straight-line (or “as the crow flies”) distances. This is a simplistic, +but relatively appealing approach because it requires little additional +data and is straight-forward to understand. stplanr +provides functionality that calculates catchment areas using +straight-line distances with the calc_catchment function. +This function takes a SpatialPolygonsDataFrame that +contains the population (or other) data, typically from a census, and a +Spatial* layer that contains the geometry of the transport +facility. These two layers are overlayed to calculate statistics for the +desired catchments including proportioning polygons to account for the +proportion located within the catchment area.

+

To illustrate how catchment areas can be calculated, +stplanr contains some sample datasets stored in ESRI +Shapefile format (a commonly used format for distributing GIS layers) +that can together be used to calculate sample catchment areas. One of +these datasets (smallsa1) contains population data for +Statistical Area 1 (SA1) zones in Sydney, Australia. The second contains +hypothetical cycleways aligned to streets in Sydney. The code below +unzips the datasets and reads in the shapefiles.

-catch800m <- calc_catchment(
-  polygonlayer = sa1income,
-  targetlayer = testcycleway,
-  calccols = c("Total"),
-  distance = 800,
-  projection = "austalbers",
-  dissolve = TRUE
-)
-

By looking at the data.frame associated with the SpatialPolygonsDataFrame that is returned from the calc_catchment function, the total population within the catchment area can be seen to be nearly 40,000 people. The catchment area can also be plotted as with any other Spatial* object using the plot function using the code below with the result shown in Figure .

+data_dir <- system.file("extdata", package = "stplanr") +unzip(file.path(data_dir, "smallsa1.zip")) +unzip(file.path(data_dir, "testcycleway.zip")) +sa1income <- as(sf::read_sf("smallsa1.shp"), "Spatial") +testcycleway <- as(sf::read_sf("testcycleway.shp"), "Spatial") +# Remove unzipped files +file.remove(list.files(pattern = "^(smallsa1|testcycleway).*"))
+

Calculating the catchment area is straightforward and in addition to +specifying the required datasets, only a vector containing column names +to calculate statistics and a distance is required. Since proportioning +the areas assumes projected data, unprojected data are automatically +projected to either a common projection (if one is already projected) or +a specified projection. It should be emphasised that the choice of +projection is important and has an effect on the results meaning setting +a local projection is recommended to achieve the most accurate +results.

-plot(sa1income, col = "light grey")
-plot(catch800m, col = rgb(1, 0, 0, 0.5), add = TRUE)
-plot(testcycleway, col = "green", add = TRUE)
-

This simplistic catchment area is useful when the straight-line distance is a reasonable approximation of the route taken to walk (or cycle) to a transport facility. However, this is often not the case. The catchment area in Figure initially appears reasonable but the red-shaded catchment area includes an area that requires travelling around a bay to access from the (green-coloured) cycleway. To allow for more realistic catchment areas for most situations, stplanr provides the calc_network_catchment function that uses the same principle as calc_catchment but also takes into account the transport network.

-

To use calc_network_catchment, a transport network needs to be prepared that can be used in conjunction with the previous datasets. Preparation of the dataset involves using the SpatialLinesNetwork function to create a network from a SpatialLinesDataFrame. This function combines a SpatialLinesDataFrame with a graph network (using the package) to provide basic routing functionality. The network is used to calculate the shortest actual paths within the specific catchment distance. This process involves the following code:

+remotes::install_github("ropensci/stplanr") +catch800m <- calc_catchment( + polygonlayer = sa1income, + targetlayer = testcycleway, + calccols = c("Total"), + distance = 800, + projection = "austalbers", + dissolve = TRUE +)
+

By looking at the data.frame associated with the +SpatialPolygonsDataFrame that is returned from the +calc_catchment function, the total population within the +catchment area can be seen to be nearly 40,000 people. The catchment +area can also be plotted as with any other Spatial* object +using the plot function using the code below with the +result shown in Figure \(\ref{fig:catchmentplot}\).

-unzip(file.path(data_dir, "sydroads.zip"))
-sydroads <- as(sf::read_sf(".", "roads"), "Spatial")
-file.remove(list.files(pattern = "^(roads).*"))
-sydnetwork <- SpatialLinesNetwork(sydroads)
-

The network catchment is then calculated using a similar method as with calc_catchment but with a few minor changes. Specifically these are including the SpatialLinesNetwork, and using the maximpedance parameter to define the distance, with distance being the additional distance from the network. In contrast to the distance parameter that is based on the straight-line distance in both the calc_catchment and calc_network_catchment functions, the maximpedance parameter is the maximum value in the units of the network’s weight attribute. In practice this is generally distance in metres but can also be travel times, risk or other measures.

+plot(sa1income, col = "light grey") +plot(catch800m, col = rgb(1, 0, 0, 0.5), add = TRUE) +plot(testcycleway, col = "green", add = TRUE) +

This simplistic catchment area is useful when the straight-line +distance is a reasonable approximation of the route taken to walk (or +cycle) to a transport facility. However, this is often not the case. The +catchment area in Figure \(\ref{fig:catchmentplot}\) initially appears +reasonable but the red-shaded catchment area includes an area that +requires travelling around a bay to access from the (green-coloured) +cycleway. To allow for more realistic catchment areas for most +situations, stplanr provides the +calc_network_catchment function that uses the same +principle as calc_catchment but also takes into account the +transport network.

+

To use calc_network_catchment, a transport network needs +to be prepared that can be used in conjunction with the previous +datasets. Preparation of the dataset involves using the +SpatialLinesNetwork function to create a network from a +SpatialLinesDataFrame. This function combines a +SpatialLinesDataFrame with a graph network (using the +package) to provide basic routing functionality. The network is used to +calculate the shortest actual paths within the specific catchment +distance. This process involves the following code:

-netcatch800m <- calc_network_catchment(
-  sln = sydnetwork,
-  polygonlayer = sa1income,
-  targetlayer = testcycleway,
-  calccols = c("Total"),
-  maximpedance = 800,
-  distance = 100,
-  projection = "austalbers"
-)
-

Once calculated, the network catchment area can be used just as the straight-line network catchment. This includes extracting the catchment population of 128,000 and plotting the original catchment area together with the original area with the results shown in Figure :

+unzip(file.path(data_dir, "sydroads.zip")) +sydroads <- as(sf::read_sf(".", "roads"), "Spatial") +file.remove(list.files(pattern = "^(roads).*")) +sydnetwork <- SpatialLinesNetwork(sydroads) +

The network catchment is then calculated using a similar method as +with calc_catchment but with a few minor changes. +Specifically these are including the SpatialLinesNetwork, +and using the maximpedance parameter to define the +distance, with distance being the additional distance from the network. +In contrast to the distance parameter that is based on the straight-line +distance in both the calc_catchment and +calc_network_catchment functions, the +maximpedance parameter is the maximum value in the units of +the network’s weight attribute. In practice this is generally distance +in metres but can also be travel times, risk or other measures.

-plot(sa1income, col = "light grey")
-plot(catch800m, col = rgb(1, 0, 0, 0.5), add = TRUE)
-plot(netcatch800m, col = rgb(0, 0, 1, 0.5), add = TRUE)
-plot(testcycleway, col = "green", add = TRUE)
- - -
-

-Modelling and visualisation

-
-

-Modelling mode choice

-

Route-allocated lines allow estimation of route distance and cirquity (route distance divided by Euclidean distance). These variables can help model the rate of flow between origins and destination, as illustrated in the left-hand panel of Figure . The code below demonstrates how objects generated by stplanr can be used to undertake such analysis, with the line_length function used to find the distance, in meters, of lat/lon data.

-
l$d_euclidean <- line_length(l)
-l$d_rf <- routes_fast@data$length
-plot(l$d_euclidean, l$d_rf,
-  xlab = "Euclidean distance", ylab = "Route distance")
-abline(a = 0, b = 1)
-abline(a = 0, b = 1.2, col = "green")
-abline(a = 0, b = 1.5, col = "red")
-

The left hand panel of Figure shows the expected strong correlation between Euclidean (\(d_E\)) and fastest route (\(d_{Rf}\)) distance. However, some OD pairs have a proportionally higher route distance than others, as illustrated by distance from the black line in the above plot: this represents : the ratio of network distance to Euclidean distance :

+netcatch800m <- calc_network_catchment( + sln = sydnetwork, + polygonlayer = sa1income, + targetlayer = testcycleway, + calccols = c("Total"), + maximpedance = 800, + distance = 100, + projection = "austalbers" +)
+

Once calculated, the network catchment area can be used just as the +straight-line network catchment. This includes extracting the catchment +population of 128,000 and plotting the original catchment area together +with the original area with the results shown in Figure \(\ref{fig:netcatchplot}\):

+
+plot(sa1income, col = "light grey")
+plot(catch800m, col = rgb(1, 0, 0, 0.5), add = TRUE)
+plot(netcatch800m, col = rgb(0, 0, 1, 0.5), add = TRUE)
+plot(testcycleway, col = "green", add = TRUE)
+
+ +
+

Modelling and visualisation +

+
+

Modelling mode choice +

+

Route-allocated lines allow estimation of route distance and +cirquity (route distance divided by Euclidean distance). These +variables can help model the rate of flow between origins and +destination, as illustrated in the left-hand panel of Figure \(\ref{fig:euclidfastest}\). The code below +demonstrates how objects generated by stplanr can be +used to undertake such analysis, with the line_length +function used to find the distance, in meters, of lat/lon data.

+
l$d_euclidean <- line_length(l)
+l$d_rf <- routes_fast@data$length
+plot(l$d_euclidean, l$d_rf,
+  xlab = "Euclidean distance", ylab = "Route distance")
+abline(a = 0, b = 1)
+abline(a = 0, b = 1.2, col = "green")
+abline(a = 0, b = 1.5, col = "red")
+

The left hand panel of Figure \(\ref{fig:euclidfastest}\) shows the +expected strong correlation between Euclidean (\(d_E\)) and fastest route (\(d_{Rf}\)) distance. However, some OD pairs +have a proportionally higher route distance than others, as illustrated +by distance from the black line in the above plot: this represents : the +ratio of network distance to Euclidean distance :

\[ - Q = \frac{d_{Rf}}{d_E} +Q = \frac{d_{Rf}}{d_E} \]

-

An extension to the concept of cirquity is the ‘quietness diversion factor’ (\(QDF\)) of a desire line , the ratio of the route distance of a quiet route option (\(d_{Rq}\)) to that of the fastest:

+

An extension to the concept of cirquity is the ‘quietness diversion +factor’ (\(QDF\)) of a desire line , +the ratio of the route distance of a quiet route option (\(d_{Rq}\)) to that of the fastest:

\[ - QDF = \frac{d_{Rq}}{d_{Rf}} +QDF = \frac{d_{Rq}}{d_{Rf}} \]

-

Thanks to the ‘quietest’ route option provided by route_cyclestreet, we can estimate average values for both metrics as follows:

-
-routes_slow <- line2route(l, route_cyclestreet, plan = "quietest")
+

Thanks to the ‘quietest’ route option provided by +route_cyclestreet, we can estimate average values for both +metrics as follows:

-l$d_rq <- routes_slow$length # quietest route distance
-Q <- mean(l$d_rf / l$d_euclidean, na.rm = TRUE)
-QDF <- mean(l$d_rq / l$d_rf, na.rm = TRUE)
-Q
-QDF
-

The results show that cycle paths are not particularly direct in the study region by international standards . This is hardly surprisingly given the small size of the sample and the short distances covered: \(Q\) tends to decrease at a decaying rate with distance. What is surprising is that \(QDF\) is close to unity, which could imply that the quiet routes are constructed along direct, and therefore sensible routes. We should caution against such assumptions, however: It is a small sample of desire lines and, when time is explored, we find that the ‘quietness diversion factor with respect to time’ (\(QDF_t\)) is slightly larger:

+routes_slow <- line2route(l, route_cyclestreet, plan = "quietest")
-(QDFt <- mean(routes_slow$time / routes_fast$time, na.rm = TRUE))
-
-
-

-Models of travel behaviour

-

There are many ways of estimating flows between origins and destinations, including spatial interaction models, the four-stage transport model and gravity models (‘distance decay’). stplanr aims eventually to facilitate creation of many types of flow model.

-

At present there are no functions for modelling distance decay, but this is something we would like to add in future versions of stplanr. Distance decay is an especially important concept for sustainable transport planning due to physical limitations on the ability of people to walk and cycle large distances .

-

We can explore the relationship between distance and the proportion of trips made by walking, using the same object l generated by stplanr.

+l$d_rq <- routes_slow$length # quietest route distance +Q <- mean(l$d_rf / l$d_euclidean, na.rm = TRUE) +QDF <- mean(l$d_rq / l$d_rf, na.rm = TRUE) +Q +QDF
+

The results show that cycle paths are not particularly direct in the +study region by international standards . This is hardly surprisingly +given the small size of the sample and the short distances covered: +\(Q\) tends to decrease at a decaying +rate with distance. What is surprising is that \(QDF\) is close to unity, which could imply +that the quiet routes are constructed along direct, and therefore +sensible routes. We should caution against such assumptions, however: It +is a small sample of desire lines and, when time is explored, we find +that the ‘quietness diversion factor with respect to time’ (\(QDF_t\)) is slightly larger:

-l$pwalk <- l$On.foot / l$All
-plot(l$d_euclidean, l$pwalk,
-  cex = l$All / 50,
-  xlab = "Euclidean distance (m)", ylab = "Proportion of trips by foot"
-)
-

Based on the right-hand panel in Figure , there is a clear negative relationship between distance of trips and the proportion of those trips made by walking. This is unsurprising: beyond a certain distance (around 1.5km according the the data presented in the figure above) walking is usually seen as too slow and other modes are considered. According to the academic literature, this ‘distance decay’ is non-linear and there have been a number of functions proposed to fit to distance decay curves . From the range of options we test below just two forms. We will compare the ability of linear and log-square-root functions to fit the data contained in l for walking.

+(QDFt <- mean(routes_slow$time / routes_fast$time, na.rm = TRUE)) + +
+

Models of travel behaviour +

+

There are many ways of estimating flows between origins and +destinations, including spatial interaction models, the four-stage +transport model and gravity models (‘distance decay’). +stplanr aims eventually to facilitate creation of many +types of flow model.

+

At present there are no functions for modelling distance decay, but +this is something we would like to add in future versions of +stplanr. Distance decay is an especially important +concept for sustainable transport planning due to physical limitations +on the ability of people to walk and cycle large distances .

+

We can explore the relationship between distance and the proportion +of trips made by walking, using the same object l generated +by stplanr.

-lm1 <- lm(pwalk ~ d_euclidean, data = l@data, weights = All)
-lm2 <- lm(pwalk ~ d_rf, data = l@data, weights = All)
-lm3 <- glm(pwalk ~ d_rf + I(d_rf^0.5),
-  data = l@data, weights = All, family = quasipoisson(link = "log")
-)
-

The results of these regression models can be seen using summary(). Surprisingly, Euclidean distance was a better predictor of walking than route distance, but no strong conclusions can be drawn from this finding, with such a small sample of desire lines (n = 42). The results are purely illustrative, of the kind of the possibilities created by using stplanr in conjuction with R’s modelling capabilities (see Figure ).

+l$pwalk <- l$On.foot / l$All +plot(l$d_euclidean, l$pwalk, + cex = l$All / 50, + xlab = "Euclidean distance (m)", ylab = "Proportion of trips by foot" +)
+

Based on the right-hand panel in Figure \(\ref{fig:euclidfastest}\), there is a clear +negative relationship between distance of trips and the proportion of +those trips made by walking. This is unsurprising: beyond a certain +distance (around 1.5km according the the data presented in the figure +above) walking is usually seen as too slow and other modes are +considered. According to the academic literature, this ‘distance decay’ +is non-linear and there have been a number of functions proposed to fit +to distance decay curves . From the range of options we test below just +two forms. We will compare the ability of linear and log-square-root +functions to fit the data contained in l for walking.

-plot(l$d_euclidean, l$pwalk,
-  cex = l$All / 50,
-  xlab = "Euclidean distance (m)", ylab = "Proportion of trips by foot"
-)
-l2 <- data.frame(d_euclidean = 1:5000, d_rf = 1:5000)
-lm1p <- predict(lm1, l2)
-lm2p <- predict(lm2, l2)
-lm3p <- predict(lm3, l2)
-lines(l2$d_euclidean, lm1p)
-lines(l2$d_euclidean, exp(lm2p), col = "green")
-lines(l2$d_euclidean, exp(lm3p), col = "red")
- -
-

-Visualisation

-

Visualisation is an important aspect of any transport study, as it enables researchers to communicate their findings to other researchers, policy-makers and, ultimately, the public. It may therefore come as a surprise that stplanr contains no functions for visualisation. Instead, users are encouraged to make use of existing spatial visualisation tools in R, such as tmap, leaflet and ggmap .

-

Furthermore, with the development of online application frameworks such as shiny, it is now easier than ever to make the results of transport analysis and modelling projects available to the public. An example is the online interface of the Propensity to Cycle Tool (PCT). The results of the project, generated using stplanr, are presented at zone, desire line and Route Network levels . There is great potential to expand on the principle of publicly accessible transport planning tools via ‘web apps,’ perhaps through new R packages dedicated to visualising transport data.

-
- -
-

-Future directions of travel

-

This paper has demonstrated the great potential for R to be used for transport planning. R’s flexibility, powerful GIS capabilities and free accessibility makes it well-suited to the needs of transport planners and researchers, especially those wanting to avoid the high costs of market-leading products. Rather than ‘reinvent the wheel’ (e.g. with a new class system), stplanr builds on existing packages and classes to work with common transport data formats.

-

It is useful to see stplanr, and R for transport planning in general, as an addition tool in the transport planner’s cabinet. It can be understood as one part of a wider movement that is making transport planning a more open and democratic process. Other developments in this movement include the increasing availability of open data and the rise of open source products for transport modelling, such as SUMO, MATSim and MITSIMLAB . stplanr, with its focus on GIS operations rather than microscopic vehicle-level behaviour, can complement such software and help make better use of new open data sources.

-

Because transport planning is an inherently spatial activity, stplanr occupies an important niche in the transport planning software landscape, with its focus on spatial transport data. There is great potential for development of stplanr in many directions. Desirable developments include the additional of functions for modelling modal split, for examample with functions to create commonly distance decay curves which are commonly found in active travel research and improving the computational efficiency of existing functions to make the methods more scalable for large databases. Our priority for stplanr however, is to keep the focus on geographic functions for transport planning. There are many opportunities in this direction, including:

+lm1 <- lm(pwalk ~ d_euclidean, data = l@data, weights = All) +lm2 <- lm(pwalk ~ d_rf, data = l@data, weights = All) +lm3 <- glm(pwalk ~ d_rf + I(d_rf^0.5), + data = l@data, weights = All, family = quasipoisson(link = "log") +)
+

The results of these regression models can be seen using +summary(). Surprisingly, Euclidean distance was a better +predictor of walking than route distance, but no strong conclusions can +be drawn from this finding, with such a small sample of desire lines (n += 42). The results are purely illustrative, of the kind of the +possibilities created by using stplanr in conjuction +with R’s modelling capabilities (see Figure ).

+
+plot(l$d_euclidean, l$pwalk,
+  cex = l$All / 50,
+  xlab = "Euclidean distance (m)", ylab = "Proportion of trips by foot"
+)
+l2 <- data.frame(d_euclidean = 1:5000, d_rf = 1:5000)
+lm1p <- predict(lm1, l2)
+lm2p <- predict(lm2, l2)
+lm3p <- predict(lm3, l2)
+lines(l2$d_euclidean, lm1p)
+lines(l2$d_euclidean, exp(lm2p), col = "green")
+lines(l2$d_euclidean, exp(lm3p), col = "red")
+ +
+

Visualisation +

+

Visualisation is an important aspect of any transport study, as it +enables researchers to communicate their findings to other researchers, +policy-makers and, ultimately, the public. It may therefore come as a +surprise that stplanr contains no functions for +visualisation. Instead, users are encouraged to make use of existing +spatial visualisation tools in R, such as tmap, +leaflet and ggmap .

+

Furthermore, with the development of online application frameworks +such as shiny, it is now easier than ever to make the +results of transport analysis and modelling projects available to the +public. An example is the online interface of the Propensity to Cycle +Tool (PCT). The results of the project, generated using +stplanr, are presented at zone, desire line and Route +Network levels . There is great potential to expand on the principle of +publicly accessible transport planning tools via ‘web apps’, perhaps +through new R packages dedicated to visualising transport data.

+
+ +
+

Future directions of travel +

+

This paper has demonstrated the great potential for R to be used for +transport planning. R’s flexibility, powerful GIS capabilities and free +accessibility makes it well-suited to the needs of transport planners +and researchers, especially those wanting to avoid the high costs of +market-leading products. Rather than ‘reinvent the wheel’ (e.g. with a +new class system), stplanr builds on existing packages +and classes to work with common transport data formats.

+

It is useful to see stplanr, and R for transport +planning in general, as an addition tool in the transport planner’s +cabinet. It can be understood as one part of a wider movement that is +making transport planning a more open and democratic process. Other +developments in this movement include the increasing availability of +open data and the rise of open source products for transport modelling, +such as SUMO, +MATSim and MITSIMLAB . +stplanr, with its focus on GIS operations rather than +microscopic vehicle-level behaviour, can complement such software and +help make better use of new open data sources.

+

Because transport planning is an inherently spatial activity, +stplanr occupies an important niche in the transport +planning software landscape, with its focus on spatial transport data. +There is great potential for development of stplanr in +many directions. Desirable developments include the additional of +functions for modelling modal split, for examample with functions to +create commonly distance decay curves which are commonly found in active +travel research and improving the computational efficiency of existing +functions to make the methods more scalable for large databases. Our +priority for stplanr however, is to keep the focus on +geographic functions for transport planning. There are many +opportunities in this direction, including:

    -
  • Functions to assess the environment surrounding routes, e.g. via integration with the in-development osmdata package.
    • -
  • Functions to match different GIS routes, perhaps building on the Hausdorf distance algorithm implemented in the function gDistance.
    • -
  • Additional functions for route-allocation of travel, e.g. via an interface to the OpenTripPlanner API.
    • -
  • Functions for aggregating very large GPS trace datasets (e.g. into raster cells) for anonymisation and analysis/visualisation purposes.
    • -
  • The creation of a class system for spatial transport datasets, such as to represent spatial route and a route networks (perhaps with classes named and ). This is not a short-term priority and it would be beneficial to coincide such developments to a migration to for spatial classes.
    • +
  • Functions to assess the environment surrounding routes, e.g. via +integration with the in-development osmdata +package.
    • +
  • Functions to match different GIS routes, perhaps building on the +Hausdorf distance algorithm implemented in the function +gDistance.
    • +
  • Additional functions for route-allocation of travel, e.g. via an +interface to the OpenTripPlanner API.
    • +
  • Functions for aggregating very large GPS trace datasets (e.g. into +raster cells) for anonymisation and analysis/visualisation +purposes.
    • +
  • The creation of a class system for spatial transport datasets, such +as to represent spatial route and a route networks (perhaps with classes +named and ). This is not a short-term priority and it would be +beneficial to coincide such developments to a migration to for spatial +classes.
-

Such spatial data processing capabilities would increase the range of transport planning tasks that stplanr can facilitate. For all this planned development activity to be useful, it is vital that new functionality is intuitive. R has a famously steep learning curve. Implementing simple concepts such as consistent naming systems and ensuring ‘type stability’ can greatly improve the usability of the package. For this reason, much future work in stplanr will go into improving documentation and user-friendliness.

-

Like much open source software stplanr is an open-ended project, a work-in-progress. We have set out clear motivations for developing transport planning capabilities in R and believe that the current version of stplanr (0.1.6) provides a major step in that direction compared with what was available a couple of years ago. But there is much more to do. We therefore welcome input on where the package’s priorities should lie, how it should evolve in the future and how to ensure it is well-developed and sustained.

+

Such spatial data processing capabilities would increase the range of +transport planning tasks that stplanr can facilitate. +For all this planned development activity to be useful, it is vital that +new functionality is intuitive. R has a famously steep learning curve. +Implementing simple concepts such as consistent naming systems and +ensuring ‘type stability’ can greatly improve the usability of the +package. For this reason, much future work in stplanr +will go into improving documentation and user-friendliness.

+

Like much open source software stplanr is an +open-ended project, a work-in-progress. We have set out clear +motivations for developing transport planning capabilities in R and +believe that the current version of stplanr (0.1.6) +provides a major step in that direction compared with what was available +a couple of years ago. But there is much more to do. We therefore +welcome input on where the package’s priorities should lie, how it +should evolve in the future and how to ensure it is well-developed and +sustained.

-
-

-References

+
+

References +

-Balmer, Michael, Marcel Rieser, and Kai Nagel. 2009. “MATSim-T: Architecture and Simulation Times.” Multi-Agent Systems for Traffic and Transportation Engineering, 57–78. https://svn.vsp.tu-berlin.de/repos/public-svn/publications/vspwp/2008/08-03/3aug08.pdf. +Balmer, Michael, Marcel Rieser, and Kai Nagel. 2009. +“MATSim-T: Architecture and +Simulation Times.” Multi-Agent Systems for Traffic and +Transportation Engineering, 57–78. https://svn.vsp.tu-berlin.de/repos/public-svn/publications/vspwp/2008/08-03/3aug08.pdf.
-Banister, David. 2008. “The Sustainable Mobility Paradigm.” Transport Policy 15 (2): 73–80. https://doi.org/10.1016/j.tranpol.2007.10.005. +Banister, David. 2008. “The Sustainable Mobility Paradigm.” +Transport Policy 15 (2): 73–80. https://doi.org/10.1016/j.tranpol.2007.10.005.
-Bivand, Roger S, Edzer J Pebesma, and Virgilio G’omez-Rubio. 2013. Applied Spatial Data Analysis with R. Vol. 747248717. Springer. +Bivand, Roger S, Edzer J Pebesma, and Virgilio G’omez-Rubio. 2013. +Applied Spatial Data Analysis with R. Vol. +747248717. Springer.
-Boyce, David E., and Huw C. W. L. Williams. 2015. Forecasting Urban Travel: Past, Present and Future. Edward Elgar Publishing. +Boyce, David E., and Huw C. W. L. Williams. 2015. Forecasting +Urban Travel: Past, +Present and Future. Edward Elgar +Publishing.
-Brown, Patrick E. 2016. “Maps, Coordinate Reference Systems and Visualising Geographic Data with Mapmisc.” The R Journal 8 (1): 64–91. +Brown, Patrick E. 2016. “Maps, Coordinate Reference +Systems and Visualising Geographic Data with +Mapmisc.” The R Journal 8 (1): 64–91.
-Brown, Patrick E., and L. Zhou. 2016. “Diseasemapping: Modelling Spatial Variation in Disease Risk for Areal Data.” https://CRAN.R-project.org/package=diseasemapping. +Brown, Patrick E., and L. Zhou. 2016. “Diseasemapping: +Modelling Spatial Variation in +Disease Risk for Areal +Data.” https://CRAN.R-project.org/package=diseasemapping.
-Calenge, C. 2006. “The Package Adehabitat for the R Software: Tool for the Analysis of Space and Habitat Use by Animals.” Ecological Modelling 197: 1035. +Calenge, C. 2006. “The Package Adehabitat for the R +Software: Tool for the Analysis of Space and Habitat Use by +Animals.” Ecological Modelling 197: 1035.
-Cerin, Ester, Cindy H P Sit, Anthony Barnett, Man Chin Cheung, and Wai Man Chan. 2013. “Walking for Recreation and Perceptions of the Neighborhood Environment in Older Chinese Urban Dwellers.” Journal of Urban Health 90 (1): 56–66. https://doi.org/10.1007/s11524-012-9704-8. +Cerin, Ester, Cindy H P Sit, Anthony Barnett, Man Chin Cheung, and Wai +Man Chan. 2013. “Walking for Recreation and Perceptions of the +Neighborhood Environment in Older Chinese Urban +Dwellers.” Journal of Urban Health 90 (1): 56–66. https://doi.org/10.1007/s11524-012-9704-8.
-de Dios Ortuzar, Juan, and Luis G. Willumsen. 2011. Modelling Transport. John Wiley & Sons. +de Dios Ortuzar, Juan, and Luis G. Willumsen. 2011. Modelling +Transport. John Wiley & Sons.
-Diana, Marco. 2012. “Studying Patterns of Use of Transport Modes Through Data Mining.” Transportation Research Record: Journal of the Transportation Research Board 2308 (December): 1–9. https://doi.org/10.3141/2308-01. +Diana, Marco. 2012. “Studying Patterns of +Use of Transport Modes +Through Data Mining.” +Transportation Research Record: Journal of the Transportation +Research Board 2308 (December): 1–9. https://doi.org/10.3141/2308-01.
-Efthymiou, Dimitrios, and Constantinos Antoniou. 2012. “Use of Social Media for Transport Data Collection.” Procedia - Social and Behavioral Sciences 48 (August 2016): 775–85. https://doi.org/10.1016/j.sbspro.2012.06.1055. +Efthymiou, Dimitrios, and Constantinos Antoniou. 2012. “Use of +Social Media for Transport +Data Collection.” Procedia - Social +and Behavioral Sciences 48 (August 2016): 775–85. https://doi.org/10.1016/j.sbspro.2012.06.1055.
-Hollander, Yaron. 2016. Transport Modelling for a Complete Beginner. CTthink! +Hollander, Yaron. 2016. Transport Modelling for a +Complete Beginner. CTthink!
-Jalal, Hawre, Petros Pechlivanoglou, Eline Krijkamp, Fernando Alarid-Escudero, Eva Enns, and M. G. Myriam Hunink. 2017. “An Overview of R in Health Decision Sciences.” Medical Decision Making, January, 0272989X16686559. https://doi.org/10.1177/0272989X16686559. +Jalal, Hawre, Petros Pechlivanoglou, Eline Krijkamp, Fernando +Alarid-Escudero, Eva Enns, and M. G. Myriam Hunink. 2017. “An +Overview of R in Health Decision +Sciences.” Medical Decision Making, January, +0272989X16686559.
-Kim, Albert Y., and Jon Wakefield. 2016. “SpatialEpi: Methods and Data for Spatial Epidemiology.” https://CRAN.R-project.org/package=SpatialEpi. +Kim, Albert Y., and Jon Wakefield. 2016. “SpatialEpi: +Methods and Data for Spatial +Epidemiology.” https://CRAN.R-project.org/package=SpatialEpi.
-Lovelace, Robin, and Richard Ellison. 2018. “Stplanr: A Package for Transport Planning.” The R Journal 10 (2): 7–23. https://doi.org/10.32614/RJ-2018-053. +Lovelace, Robin, and Richard Ellison. 2018. “Stplanr: A +Package for Transport Planning.” The R +Journal 10 (2): 7–23. https://doi.org/10.32614/RJ-2018-053.
-Lovelace, Robin, Anna Goodman, Rachel Aldred, Nikolai Berkoff, Ali Abbas, and James Woodcock. 2017. “The Propensity to Cycle Tool: An Open Source Online System for Sustainable Transport Planning.” Journal of Transport and Land Use 10 (1). https://doi.org/10.5198/jtlu.2016.862. +Lovelace, Robin, Anna Goodman, Rachel Aldred, Nikolai Berkoff, Ali +Abbas, and James Woodcock. 2017. “The Propensity to +Cycle Tool: An Open Source Online +System for Sustainable Transport Planning.” Journal of +Transport and Land Use 10 (1). https://doi.org/10.5198/jtlu.2016.862.
-Moore, R. D. (Dan), and David Hutchinson. 2017. “Why Watershed Analysts Should Use R for Data Processing and Analysis.” Confluence: Journal of Watershed Science and Management 1 (1). http://confluence-jwsm.ca/index.php/jwsm/article/view/2. +Moore, R. D. (Dan), and David Hutchinson. 2017. “Why +Watershed Analysts Should Use R for Data +Processing and Analysis.” Confluence: +Journal of Watershed Science and Management 1 (1). http://confluence-jwsm.ca/index.php/jwsm/article/view/2.
-Pebesma, Edzer, Roger Bivand, Paulo Justiniano Ribeiro, and others. 2015. “Software for Spatial Statistics.” Journal of Statistical Software 63 (1): 1–8. http://brage.bibsys.no/xmlui/bitstream/id/320781/Pebesma_Bivand_Ribeiro.pdf. +Pebesma, Edzer, Roger Bivand, Paulo Justiniano Ribeiro, et al. 2015. +“Software for Spatial +Statistics.” Journal of Statistical +Software 63 (1): 1–8. http://brage.bibsys.no/xmlui/bitstream/id/320781/Pebesma_Bivand_Ribeiro.pdf.
-Waddell, Paul. 2002. “UrbanSim: Modeling Urban Development for Land Use, Transportation, and Environmental Planning.” Journal of the American Planning Association 68 (3): 297–314. +Waddell, Paul. 2002. “UrbanSim: Modeling +Urban Development for Land Use, Transportation, and Environmental +Planning.” Journal of the American Planning Association +68 (3): 297–314.
-Zheng, Xinhu, Wei Chen, Pu Wang, Dayong Shen, Songhang Chen, Xiao Wang, Qingpeng Zhang, and Liuqing Yang. 2016. “Big Data for Social Transportation.” IEEE Transactions on Intelligent Transportation Systems 17 (3): 620–30. https://ieeexplore.ieee.org/abstract/document/7359138/. -
-
+Zheng, Xinhu, Wei Chen, Pu Wang, Dayong Shen, Songhang Chen, Xiao Wang, +Qingpeng Zhang, and Liuqing Yang. 2016. “Big Data for Social +Transportation.” IEEE Transactions on Intelligent +Transportation Systems 17 (3): 620–30. https://ieeexplore.ieee.org/abstract/document/7359138/.
-
-
-
    -

  1. Many people can think of things that could be improved on their local transport networks, especially for walking, cycling and wheel-chairs. But most lack the evidence to communicate the issues, and potential solutions, to others.↩︎

    2. -

  2. An API key is needed for this function to work. This can be requested (or purchased for large scale routing) from cyclestreets.net/api/apply. See ?route_cyclestreet for details. Thanks to Martin Lucas-Smith and Simon Nuttall for making this possible.↩︎

    3. -
-
- - + - + diff --git a/docs/authors.html b/docs/authors.html index 4682de35..b59c2b75 100644 --- a/docs/authors.html +++ b/docs/authors.html @@ -1,150 +1,108 @@ - - - - - - - -Citation and Authors • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Citation

- Source: inst/CITATION +
+

Authors and Citation

-

Lovelace, R. and Ellison, R., 2017. stplanr: A Package for Transport Planning. The R Journal. https://doi.org/10.32614/RJ-2018-053

- 
@Article{,
+    

+      
Authors

+      
+      
  • 
+          
    Robin Lovelace. Author, maintainer. 
+          
    
+        
    • 
+        
  • 
+          
    Richard Ellison. Author. 
+          
    
+        
    • 
+        
  • 
+          
    Malcolm Morgan. Author. 
+          
    
+        
    • 
+        
  • 
+          
    Barry Rowlingson. Contributor. 
+          
    
+        
    • 
+        
  • 
+          
    Nick Bearman. Contributor. 
+          
    
+        
    • 
+        
  • 
+          
    Nikolai Berkoff. Contributor. 
+          
    
+        
    • 
+        
  • 
+          
    Scott  Chamberlain. Reviewer. 
+          
    Scott reviewed the package for rOpenSci, see https://github.com/ropensci/onboarding/issues/10
    
+        
    • 
+        
  • 
+          
    Mark Padgham. Contributor. 
+          
    
+        
    • 
+        
  • 
+          
    Andrea Gilardi. Contributor. 
+          
    
+        
    • 
+      

+
+    

+      
Citation

+      
Source: inst/CITATION

+
+      
Lovelace, R. and Ellison, R., 2017. stplanr: A Package for Transport Planning. The R Journal. https://doi.org/10.32614/RJ-2018-053

+      
@Article{,
   author = {{Robin Lovelace} and {Richard Ellison}},
   title = {{stplanr: A Package for Transport Planning}},
   year = {2018},
@@ -153,108 +111,55 @@ 
Citation

   journal = {{The R Journal}},
   url = {https://doi.org/10.32614/RJ-2018-053},
 }

-
-    

-      
Authors

     

-
-    
    
-      
  • 
-        
    Robin Lovelace. Author, maintainer. 
-        
    
-      
    • 
-      
  • 
-        
    Richard Ellison. Author. 
-        
    
-      
    • 
-      
  • 
-        
    Malcolm Morgan. Author. 
-        
    
-      
    • 
-      
  • 
-        
    Barry Rowlingson. Contributor. 
-        
    Author of overline
    
-      
    • 
-      
  • 
-        
    Nick Bearman. Contributor. 
-        
    Co-author of gclip
    
-      
    • 
-      
  • 
-        
    Nikolai Berkoff. Contributor. 
-        
    Co-author of line2route
    
-      
    • 
-      
  • 
-        
    Scott  Chamberlain. Reviewer. 
-        
    Scott reviewed the package for rOpenSci, see https://github.com/ropensci/onboarding/issues/10
    
-      
    • 
-      
  • 
-        
    Mark Padgham. Contributor. 
-        
    
-      
    • 
-      
  • 
-        
    Andrea Gilardi. Contributor. 
-        
    
-      
    • 
-    

-
-  

-
-
+
- -
+ - - + + diff --git a/docs/index.html b/docs/index.html index 3ef5423a..0c13206b 100644 --- a/docs/index.html +++ b/docs/index.html @@ -4,360 +4,352 @@ - + + Sustainable Transport Planning • stplanr - + - - - - - - - - - - + + + + + + + + - -
-
-
-
-

-stplanr -

-

rstudio mirror downloads CRAN_Status_Badge lifecycle R-CMD-check

+

rstudio mirror downloads CRAN_Status_Badge lifecycle R-CMD-check

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.

-
-

-Key functions

+

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.

+
+

Key functions +

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 x 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.804098
+od_data_sample[1:3, 1:3] # typical form of flow data +#> # A tibble: 3 x 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.804098

These 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)
+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():

+

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"
-  )
-#> Most common output is sf
-mapview::mapview(trip)
+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" + ) +#> Most common output is sf +mapview::mapview(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"
-  )
-#> Most common output is sf
-mapview::mapview(trip2)
+trip2 <- route( + from = "Leeds", + to = "Bradford", + route_fun = osrmRoute, + returnclass = "sf" + ) +#> Most common output is sf +mapview::mapview(trip2)

We can replicate this call multiple times with the l argument in route():

-desire_lines <- travel_network[2:6, ]
+desire_lines <- travel_network[2:6, ]

Next, we’ll calculate the routes:

-routes <- route(
-  l = desire_lines,
-  route_fun = osrmRoute,
-  returnclass = "sf"
-  )
-mapview::mapview(routes) +
-  mapview::mapview(desire_lines, color = "red")
+routes <- route( + l = desire_lines, + route_fun = osrmRoute, + returnclass = "sf" + ) +mapview::mapview(routes) + + mapview::mapview(desire_lines, color = "red")

-

For more examples, example("route").

+

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")
-#> 2020-09-03 22:24:08 constructing segments
-#> 2020-09-03 22:24:08 building geometry
-#> 2020-09-03 22:24:08 simplifying geometry
-#> 2020-09-03 22:24:08 aggregating flows
-#> 2020-09-03 22:24:08 rejoining segments into linestrings
+routes$foot <- desire_lines$foot +rnet <- overline(routes, attrib = "foot") +#> 2020-09-03 22:24:08 constructing segments +#> 2020-09-03 22:24:08 building geometry +#> 2020-09-03 22:24:08 simplifying geometry +#> 2020-09-03 22:24:08 aggregating flows +#> 2020-09-03 22:24:08 rejoining segments into linestrings

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)
+plot(rnet["foot"], lwd = rnet$foot)

The above plot represents the number walking trips made (the ‘flow’) along particular segments of a transport network.

-
-

-Policy applications

-

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.

+
+

Policy applications +

+

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.

-
-

-Installation

+
+

Installation +

To install the stable version, use:

-install.packages("stplanr")
+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)
+# install.packages("devtools") # if not already installed +devtools::install_github("ropensci/stplanr") +library(stplanr)

stplanr depends on rgdal, which can be tricky to install.

-
-

-Installing stplanr on Linux and Mac

-

stplanr depends on sf. Installation instructions for Mac, Ubuntu and other Linux distros can be found here: https://github.com/r-spatial/sf#installing

+
+

Installing stplanr on Linux and Mac +

+

stplanr depends on sf. Installation instructions for Mac, Ubuntu and other Linux distros can be found here: https://github.com/r-spatial/sf#installing

-
-

-Funtions, help and contributing

-

The current list of available functions can be seen on the package’s website at docs.ropensci.org/stplanr/, or with the following command:

+
+

Functions, help and contributing +

+

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)
+lsf.str("package:stplanr", all = TRUE)

To get internal help on a specific function, use the standard way.

-?od2line
-

To contribute, report bugs or request features, see the issue tracker.

+?od2line
+

To contribute, report bugs or request features, see the issue tracker.

-
-

-Further resources / tutorials

+
+

Further resources / tutorials +

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):

-
-

-Meta

+
+

Meta +

-

rofooter

+

rofooter

-
- - - + diff --git a/docs/news/index.html b/docs/news/index.html index 6a950442..f6f7a1a0 100644 --- a/docs/news/index.html +++ b/docs/news/index.html @@ -1,453 +1,341 @@ - - - - - - - -Changelog • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Changelog

- Source: NEWS.md +
+

Changelog

+ Source: NEWS.md
-
-

-stplanr (development version) Unreleased -

-
-
-

-stplanr 0.8.0 2020-10-28 -

- -
-
-

-stplanr 0.7.2 2020-09-04 -

-
    -
  • Support sf objects for toptail_buff() -
    • -
  • Updated examples for tests and README to enable tests to pass on legacy versions of PROJ (#423)
    • -
  • Reduce vulnerability to upcoming upstream changes (#426)
    • -
-
-
-

-stplanr 0.7.1 2020-08-28 -

-
    -
  • Tweaks to the documentation and examples for CRAN tests
    • -
-
-
-

-stplanr 0.7.0 2020-08-27 -

-
    -
  • Issue with line2points() on some set-ups fixed (#418)
    • -
  • Old mapshape(), line_match() and gclip() functions deprecated, maintained alternatives can now be found in other packages.
    • -
  • -sp objects updated for latest version of sp (#364)
    • -
  • -sf objects updated to support more recent CRS encoding (#393)
    • +
    +

    stplanr 1.0.2

    CRAN release: 2022-11-08

    +
    • Update docs, fix missing functions issue (#499)
      • +
    +
    +

    stplanr 1.0.1

    CRAN release: 2022-08-19

    +
    • Fix for breaking change in dodgr (#494)
      • +
    +
    +

    stplanr 1.0.0

    CRAN release: 2022-06-10

    +
    +
    +

    stplanr 0.9.0 (May 2022)

    CRAN release: 2022-05-11

    +
    • Message added on loading the package announcing planned changes: support for sp objects and associated packages will be dropped (#332)
      • +
    • New function line_segment_sf() (#482)
      • +
    • Various changes required by CRAN (#486)
      • +
    +
    +

    stplanr 0.8.7 (February 2022)

    CRAN release: 2022-02-01

    +
    • +route() now runs batch routing when input is a linestring and opentripplanner is installed (#459)
      • +
    +
    +

    stplanr 0.8.6 (November 2021)

    CRAN release: 2021-11-26

    +
    • +route() checks the CRS and gives an appropriate warning if it is projected
      • +
    • The package now Suggests igraph rather than depending on it making it easier to install
      • +
    +
    +

    stplanr 0.8.5

    CRAN release: 2021-11-01

    +
    • No longer Suggests stats19 package
      • +
    +
    +

    stplanr 0.8.4

    CRAN release: 2021-10-12

    +
    • No longer Suggests bench package
      • +
    • Tests pass when internet unavailable (#469)
      • +
    +
    +

    stplanr 0.8.3

    CRAN release: 2021-07-22

    +
    • Outputs of line_via() now have correct CRS
      • +
    • +calc_catchment() have been deprecated because the generate warnings
      • +
    • Minor fixes and improvements in the package’s documentation
      • +
    +
    +

    stplanr 0.8.2

    CRAN release: 2021-04-06

    +
    • Bug fixed related to the route() function: it silently failed when pbapply not installed. The package was promoted from Suggests to Imports (#460)
      • +
    +
    +

    stplanr 0.8.1

    CRAN release: 2021-01-07

    +
    • Thanks to the styler package, code in stplanr now adheres to a consistent style (using arrow <- assignment despite the maintainer’s default of equals = assignment - many = had been introduced accidentally!)
      • +
    • New function rnet_group() groups route network elements (#403)
      • +
    • +overline() now converts MULTILINESTRING geometries to LINESTRINGS automatically
      • +
    • Routing on the network using sum_network_routes() now returns a linestring for routes that start where they end (i.e. no travel) (#444)
      • +
    • Routing using route_local() fixed: the l argument now works (#448)
      • +
    • New route_osrm() function (#449)
      • +
    • +rnet_breakup_vertices() is now way faster, thanks to Andrea Gilardi and others (#416)
      • +
    • +rnet_group() is now a generic function that works with sfNetwork objects (#455)
      • +
    • +route_osrm() provides easy access to multi-modal routing (#449)
      • +
    • Bug in route() function’s calculation of bbox attributes fixed (#452)
      • +
    +
    +

    stplanr 0.8.0

    CRAN release: 2020-10-28

    +
    +
    +

    stplanr 0.7.2

    CRAN release: 2020-09-04

    +
    • Support sf objects for toptail_buff() +
      • +
    • Updated examples for tests and README to enable tests to pass on legacy versions of PROJ (#423)
      • +
    • Reduce vulnerability to upcoming upstream changes (#426)
      • +
    +
    +

    stplanr 0.7.1

    CRAN release: 2020-08-28

    +
    • Tweaks to the documentation and examples for CRAN tests
      • +
    +
    +

    stplanr 0.7.0

    CRAN release: 2020-08-27

    +
    • Issue with line2points() on some set-ups fixed (#418)
      • +
    • Old mapshape(), line_match() and gclip() functions deprecated, maintained alternatives can now be found in other packages.
      • +
    • +sp objects updated for latest version of sp (#364)
      • +
    • +sf objects updated to support more recent CRS encoding (#393)
    • Deprecated functions including od_aggregate(), onewayid(), gtfs2sldf(), and od_radiation() have been removed
      • -
    -
    -
    -

    -stplanr 0.6.2 2020-07-08 -

    -
    -

    -New features

    -
      -
    • New interface to Google Directions API via mapsapi package (#410)
      • +
    +
    +

    stplanr 0.6.2

    CRAN release: 2020-07-08

    +
    +

    New features

    +
    • New interface to Google Directions API via mapsapi package (#410)
    • New quiet argument in overline() makes it less chatty
      • -
    -
    -
    -
    -

    -stplanr 0.6.1 2020-06-23 -

    -
    -

    -BUG FIXES

    -
      -
    • -route() failed when data.table not installed (#408)
      • -
    -
    -
    -
    -

    -stplanr 0.6.0 2020-05-03 -

    -
    -

    -BUG FIXES

    -
    +
    +
    +

    stplanr 0.6.1

    CRAN release: 2020-06-23

    +
    +

    BUG FIXES

    +
    • +route() failed when data.table not installed (#408)
      • +
    +
    +
    +

    stplanr 0.6.0

    CRAN release: 2020-05-03

    +
    +

    BUG FIXES

    +
    • Bug in SpatialLinesNetwork() fixed thanks to Andrea Gilardi (#394)
    • Updated documentation for finding shortest paths
    • Check start and end arguments in short path calculations are numeric
    • -dodgr removed as Suggests until it’s back on CRAN (#398)
      • -
    • Updates to dplyr code to prevent warnings when using the dev version (#395)
      • -
    -
    -
    -

    -NEW FEATURES

    -
      -
    • Improvements to route() allowing you to save a list of raw outputs and use data.table for faster performance if available
      • +dodgr removed as Suggests until it’s back on CRAN (#398) +
    • Updates to dplyr code to prevent warnings when using the dev version (#395)
      • +
    +
    +

    NEW FEATURES

    +
    • Improvements to route() allowing you to save a list of raw outputs and use data.table for faster performance if available
    • A fleet of new route_rolling_*() functions have been added: -
    • -geo_toptail() function now has sf implementation (#390)
      • -
    • New cl argument in route() for parallel routing (#388)
      • +geo_toptail() function now has sf implementation (#390) +
    • New cl argument in route() for parallel routing (#388)
    • New and updated datasets representing od_data_sample in different ways: od_data_lines and od_data_routes
    • -route_graphhopper() deprecated (#389)
      • +route_graphhopper() deprecated (#389)
    • Old functions that use legacy sp and dplyr code, sp_aggregate and od_aggregate, have been deprecated
    • New work-in-progress route_slope*() functions
      • -
    -
    -
    -
    -

    -stplanr 0.5.2 2020-04-06 -

    -
    -

    -BUG FIXES

    -
      -
    • Documentation fixes (#384)
      • -
    • A bug affecting route() function calls when pbapply was not installed has been fixed (#386)
      • -
    • -oneway() has been deprecated in favour of faster and easier-to-maintain function od_oneway() (also see the in-development od package) (#387)
      • -
    • Various other changes have been made to accomodate the dev version of dplyr (#383)
      • -
    -
    -
    -
    -

    -stplanr 0.5.1 2020-03-01 -

    -
      -
    • Changes for compatibility with R 4.0.0
      • -
    -
    -
    -

    -stplanr 0.5.0 2020-01-26 -

    -
    +
    +
    +

    stplanr 0.5.2

    CRAN release: 2020-04-06

    +
    +

    BUG FIXES

    +
    • Documentation fixes (#384)
      • +
    • A bug affecting route() function calls when pbapply was not installed has been fixed (#386)
      • +
    • +oneway() has been deprecated in favour of faster and easier-to-maintain function od_oneway() (also see the in-development od package) (#387)
      • +
    • Various other changes have been made to accomodate the dev version of dplyr (#383)
      • +
    +
    +
    +

    stplanr 0.5.1

    CRAN release: 2020-03-01

    +
    • Changes for compatibility with R 4.0.0
      • +
    +
    +

    stplanr 0.5.0

    CRAN release: 2020-01-26

    +
    • +route_graphhopper() should now work with a local graphhopper instance. See https://github.com/ropensci/stplanr/pull/369 +
      • +
    • The old line2route() function now works with routing functions that return sf objects
    • The new route() function is now more resilient, providing a progress bar if you have pbapply package installed, returning a result even if some routes failed, and telling you which routes failed
    • The package has fewer dependencies, readr, openxlsx and lubridate removed
    • Deprecated function buff_geo() removed
      • -
    -
    -

    -BUG FIXES

    -
    +

    BUG FIXES

    +
    • +destination now works again as an argument in line2route() (#368)
    • overline() now accepts sf objects regardless of the name of the geometry column
    • -line2points() now works with sfc objects (#361)
      • -
    -
    -
    -
    -

    -stplanr 0.4.1 2019-11-23 -

    -
    -

    -NEW FEATURES

    - +line2points() now works with sfc objects (#361) +
+
+

stplanr 0.4.1

CRAN release: 2019-11-23

+
+

NEW FEATURES

+
-
-

-stplanr 0.4.0 2019-10-13 -

-
-

-NEW FEATURES

-
-
-

-stplanr 0.3.1 2019-09-17 -

-
    -
  • stplanr now has a logo! See #334 +
    +

    stplanr 0.3.1

    CRAN release: 2019-09-17

    +
    • stplanr now has a logo! See #334
    • line_to_points() depreciated in favour of od2line(), the latter function name being more consistent with the package’s other functions
    • line2pointsn() now works with sf objects
      • -
    • Documentation fixes - see #329 +
    • Documentation fixes - see #329
      • -
    -
    -

    -OTHER

    -
      -
    • Various improvements made to the stplanr-od vignette, thanks to Edward Leigh
      • -
    • URLs updated to link to stplanr’s new, official website: https://docs.ropensci.org/stplanr/ +
    +

    OTHER

    +
    • Various improvements made to the stplanr-od vignette, thanks to Edward Leigh
      • +
    • URLs updated to link to stplanr’s new, official website: https://docs.ropensci.org/stplanr/
      • -
    +
-
-
-

-stplanr 0.3.0 2019-07-30 -

-
-

-NEW FEATURES

-
    -
  • New functions od_to_odmatrix() and odmatrix_to_od() to convert between matrix forms of origin-destination data
    • +
    +

    stplanr 0.3.0

    CRAN release: 2019-07-30

    +
    +

    NEW FEATURES

    +
    • New functions od_to_odmatrix() and odmatrix_to_od() to convert between matrix forms of origin-destination data
    • New function od_oneway() replaces onewayid(), works better and is twice as fast
      • -
    • New od_id*() functions provide a range of ways to convert origin-destination pair IDs into a single ID. See Stackoverflow and the issue tracker -
      • -
    • New vignette stplanr-od provides detailed documentation on the package’s OD data handling capabilities
      • -
    -
    -
    -
    -

    -stplanr 0.2.10 2019-05-18 -

    -
      -
    • Fix in documentation. See #311 -
      • -
    -
    -
    -

    -stplanr 0.2.9 2019-05-10 -

    -
    -

    -NEW FEATURES

    -
      -
    • New functions od_aggregate_from() and od_aggregate_to() provide easy ways to aggregate origin-destination pairs. See #303.
      • -
    • Updated overline2() is now faster and better documented (#307)
      • -
    • Updates to route_dodgr() function, which provides an interface to the dodgr package, accepts wider range of inputs
      • +
    • New od_id*() functions provide a range of ways to convert origin-destination pair IDs into a single ID. See Stackoverflow and the issue tracker +
      • +
    • New vignette stplanr-od provides detailed documentation on the package’s OD data handling capabilities
      • +
    +
    +
    +

    stplanr 0.2.10

    CRAN release: 2019-05-18

    +
    • Fix in documentation. See #311 +
      • +
    +
    +

    stplanr 0.2.9

    CRAN release: 2019-05-10

    +
    +

    NEW FEATURES

    + -
    -
    -

    -BUG FIXES

    -
    +
    +

    BUG FIXES

    +
    • Bug in sum_network_routes() fixed. See #267
      • -
    -
    +
-
-

-stplanr 0.2.8 2019-03-22 -

-
-

-NEW FEATURES

-
    -
  • The stplanr paper has been published! See it here: https://journal.r-project.org/archive/2018/RJ-2018-053/index.html -
    • -
  • STATS19 functions such as dl_stats19() are depreciated. They have been split-out into the new package stats19 +
    +

    stplanr 0.2.8

    CRAN release: 2019-03-22

    +
    +

    NEW FEATURES

    + -
    -
    -

    -BUG FIXES

    - -
    -
    -
    -

    -stplanr 0.2.7 2019-01-07 -

    -
    -

    -NEW FEATURES

    - -
    -
    -

    -BUG FIXES

    -
      -
    • Fixed #272 by removing byvars argument of overline in preparation for overdue overhaul of overline function.
      • -
    -
    -
    -

    -OTHER

    -
      -
    • No longer suggests tmap to reduce install times: install.packages() installs suggested packages by default
      • -
    -
    -
    -
    -

    -stplanr 0.2.6 2018-10-20 -

    -
    -

    -NEW FEATURES

    - -
    -
    -

    -BUG FIXES

    -
      -
    • Issue with dl_stats19(), see #270 -
      • -
    • Make style consistent, see commit +
    +
    +

    BUG FIXES

    +
    +
    +
    +

    stplanr 0.2.7

    CRAN release: 2019-01-07

    +
    +

    NEW FEATURES

    +
    +
    +

    BUG FIXES

    +
    • Fixed #272 by removing byvars argument of overline in preparation for overdue overhaul of overline function.
      • +
    +
    +

    OTHER

    +
    • No longer suggests tmap to reduce install times: install.packages() installs suggested packages by default
      • +
    +
    +
    +

    stplanr 0.2.6

    CRAN release: 2018-10-20

    +
    +

    NEW FEATURES

    +
    • New function route_local() +
      • +
    • New argument in line2route(): time_sleep waits a period between each route request
      • +
    +
    +

    BUG FIXES

    +
    • Issue with dl_stats19(), see #270 +
      • +
    • Make style consistent, see commit
    • Various small fixes to documentation and style
      • -
    -
    -
    -
    -

    -stplanr 0.2.5 2018-06-02 -

    -
    -

    -NEW FEATURES

    -
      -
    • New function line_via() for identifying intermediary points on a transport network
      • -
    -
    -
    -

    -BUG FIXES

    - -
    -
    -
    -

    -stplanr 0.2.4 2018-05-19 -

    -
    -

    -NEW FEATURES

    -
      -
    • New function geo_length() returns numeric vector of line lengths from sp or sf objects.
      • -
    -
    -
    -

    -DOCUMENTATION

    -
      -
    • -?route_graphhopper no longer mentions the depreciated ‘bike2’ profile - see #246 -
      • -
    • -?route_osrm mentions that the public API only routes for cars - see #246 +
    +
    +
    +

    stplanr 0.2.5

    CRAN release: 2018-06-02

    +
    +

    NEW FEATURES

    +
    • New function line_via() for identifying intermediary points on a transport network
      • +
    +
    +

    BUG FIXES

    +
    • Bug associated with SpatialLinesNetwork() fixed (see #249)
      • +
    +
    +
    +

    stplanr 0.2.4

    CRAN release: 2018-05-19

    +
    +

    NEW FEATURES

    +
    • New function geo_length() returns numeric vector of line lengths from sp or sf objects.
      • +
    +
    +

    DOCUMENTATION

    +
    • +?route_graphhopper no longer mentions the depreciated ‘bike2’ profile - see #246 +
      • +
    • +?route_osrm mentions that the public API only routes for cars - see #246
    • Updated introducing-stplanr vignette to show new function and make more robust
      • -
    -
    -
    -
    -

    -stplanr 0.2.3 2018-03-06 -

    -
    -

    -NEW FEATURES

    -
    +
    +
    +

    stplanr 0.2.3

    CRAN release: 2018-03-06

    +
    +

    NEW FEATURES

    +
    • +stplanr now imports lwgeom, needed for sf::st_length(), used in SpatialLinesNetwork().
    • Plotting behaviour updated for sfNetwork objects: now only plots the geometry by default.
      • -
    • Improved documentation for SpatialLinesNetwork() and plot() for spatial networks.
      • -
    -
    -
    -

    -BUG FIXES

    - -
    -
    -
    -

    -stplanr 0.2.2 2017-12-19 -

    -
    -

    -NEW FEATURES

    -
      -
    • In this release sp is demoted from a Depends to an Imports, meaning that all its functions will not be attached to your namespace (it will not be loaded) when you run library(stplanr), making it less tied to sp. This is a continuation of the work to support sf and will make it easier for the package to work with alternative representations of geographic data.
      • -
    -
    -
    -

    -BUG FIXES

    -
      -
    • Bug in geo_select_aeq.sf() was fixed by Jakub Nowosad in pull #238 +
    • Improved documentation for SpatialLinesNetwork() and plot() for spatial networks.
      • +
    +
    +

    BUG FIXES

    +
    • Bug in sum_network_routes() fixed (see #240).
      • +
    +
    +
    +

    stplanr 0.2.2

    CRAN release: 2017-12-19

    +
    +

    NEW FEATURES

    +
    • In this release sp is demoted from a Depends to an Imports, meaning that all its functions will not be attached to your namespace (it will not be loaded) when you run library(stplanr), making it less tied to sp. This is a continuation of the work to support sf and will make it easier for the package to work with alternative representations of geographic data.
      • +
    +
    +

    BUG FIXES

    +
    • Bug in geo_select_aeq.sf() was fixed by Jakub Nowosad in pull #238
    • An issue with od_aggregate.sf() was fixed making it much faster
      • -
    +
-
-
-

-stplanr 0.2.0 Unreleased -

-
-

-NEW FEATURES

-
    -
  • This is the largest release since the package was created, with dozens of changes to support simple features - see https://github.com/ropensci/stplanr/pull/198 for details.
    • +
    +

    stplanr 0.2.0

    +
    +

    NEW FEATURES

    +
    • This is the largest release since the package was created, with dozens of changes to support simple features - see https://github.com/ropensci/stplanr/pull/198 for details.
    • Support for sf. The package now support the new spatial class system for most functions.
    • New function geo_bb() supercedes bb2poly(). The new function can return polygons, points and matrix objects determined by the output argument. It also allows bounding boxes to be extended in metres, and scaled in x and y dimensions.
    • geo_code() now uses nominatim by default to find locations on the maps.
    • New function od_coords() takes a wide range of input data types to return a consistent output representing OD data as a data frame of origin and destination coordinates. This is used behind the scenes to make other functions more modular.
      • -
    -
    -
    -

    -WORK IN PROGRESS

    +
+
+

WORK IN PROGRESS

Plans for the next release

-
    -
  • New generic route() function for routing. This is more flexible and user-friendly than the existing line2route() and route_*() functions it enhances.
    • +
    • New generic route() function for routing. This is more flexible and user-friendly than the existing line2route() and route_*() functions it enhances.
    • Updated function names to make using stplanr easier and more intuitive.
      • -
    -
+
-
-

-stplanr 0.1.9 2017-07-12 -

-
-

-NEW FEATURES

-
-
-

-stplanr 0.1.8 2017-06-02 -

-
-

-NEW FEATURES

-
-
-

-stplanr 0.1.7 2016-12-23 -

-
-

-NEW FEATURES

-
    -
  • There is a new vignette! See vignettes/stplanr-paper.Rmd and vignette("stplanr-paper") for details.
    • -
  • The original introducing-stplanr vignette has been updated. It now provides a more basic introduction for people new to R for spatial and transport data.
    • +
    +

    stplanr 0.1.7

    CRAN release: 2016-12-23

    +
    +

    NEW FEATURES

    +
    • There is a new vignette! See vignettes/stplanr-paper.Rmd and vignette("stplanr-paper") for details.
      • +
    • The original introducing-stplanr vignette has been updated. It now provides a more basic introduction for people new to R for spatial and transport data.
    • -line2route() has been refactored to improve error detection and allow n_processes arguments. Thanks @nikolai-b. See pull/151 for details.
      • +line2route() has been refactored to improve error detection and allow n_processes arguments. Thanks @nikolai-b. See pull/151 for details.
    • -line_match() function added, a wrapper around rgeos::gDistance(), to find similar routes.
      • +line_match() function added, a wrapper around rgeos::gDistance(), to find similar routes.
    • -RCurl and data.table dependencies have been removed +RCurl and data.table dependencies have been removed
    • leaflet has been demoted from an import to a suggest. This should reduce install times.
      • -
    • New functions od_aggregate() and sp_aggregate() have been added, to enable OD data to be aggregated to new geographic levels.
      • -
    -
    -
    -

    -BUG FIXES

    -
      -
    • -#141 fixed: viaroute() works again.
      • -
    • -#153 fixed: bidirectional = TRUE returns a different result in line_bearing() now.
      • -
    -
    -
    -

    -FUTURE PLANS

    -
      -
    • A new branch that uses sf is being tested. We may eventually transition to using simple features classes instead of sp classes.
      • -
    -
    -
    -
    -

    -stplanr 0.1.6 2016-11-11 -

    -
    -

    -NEW FEATURES

    -
      -
    • +
    • New functions od_aggregate() and sp_aggregate() have been added, to enable OD data to be aggregated to new geographic levels.
      • +
    +
    +

    BUG FIXES

    +
    • +#141 fixed: viaroute() works again.
      • +
    • +#153 fixed: bidirectional = TRUE returns a different result in line_bearing() now.
      • +
    +
    +

    FUTURE PLANS

    +
    • A new branch that uses sf is being tested. We may eventually transition to using simple features classes instead of sp classes.
      • +
    +
    +
    +

    stplanr 0.1.6

    CRAN release: 2016-11-11

    +
    +

    NEW FEATURES

    +
    • onewayid() is now a generic function, meaning it can handle spatial and non-spatial data
      • -
    • New arguments provided for line2route() allow you to specify variables to join-by - also has updated and more sensible defaults
      • +
    • New arguments provided for line2route() allow you to specify variables to join-by - also has updated and more sensible defaults
    • New function od_id_order() to put origin-destination ids in order, to identify 2 way duplicates (split out from onewayid())
      • -
    -
    -
    -

    -BUG FIXES

    -
    +
    +

    BUG FIXES

    +
    • See the issue tracker
    • Bug in route_cyclestreet() leading change_elev and av_incline being wrong now fixed
      • -
    • Bug making variable names with spaces in the id columns failed - now fixed #138 +
    • Bug making variable names with spaces in the id columns failed - now fixed #138
      • -
    -
    -
    -

    -stplanr 0.1.5

    +
+
+

stplanr 0.1.5

NEW FEATURES

-
    -
  • New argument destinations added to od2line(). See example(od2line) for an example.
    • +
    • New argument destinations added to od2line(). See example(od2line) for an example.
    • New dataset destinations for showing how OD matrix with destinations can be converted to spatial data
    • New argument list_output allows the route information to be saved as a list, allowing save_raw = TRUE (which does not return a Spatial object) to be passed to the route_ function.
    • tmap dependency removed for faster installs
      • -
    -

    BUG FIXES

    -

    BUG FIXES

    +
    • Bug with line2route() (#124) fixed
    • Various improvements to documentation
      • -
    -
-
-

-stplanr 0.1.4

+
+
+

stplanr 0.1.4

NEW FEATURES

-
    -

  • New function reproject() is a simple wrapper around spTransform() that uses crs_select_aeq() to convert a spatial object in geographic (lat/lon) coordinates into on with projected coordinates, with units of 1 m. This is useful for various spatial operations, such as finding the length and area of an object.

    • +

    • New function reproject() is a simple wrapper around spTransform() that uses crs_select_aeq() to convert a spatial object in geographic (lat/lon) coordinates into on with projected coordinates, with units of 1 m. This is useful for various spatial operations, such as finding the length and area of an object.

    • Implement gprojected(), a function for performing GIS operations on a temporary, projected, version of spatial objects.

    • Addition of line_bearing() to return the bearing of lines based on start and end points.

    • Addition of angle_diff() for finding the angular difference between lines: are they roughly parallel or perpendicular?

      • -
    -

    BUG FIXES

    -
      -

    • line2df() now works on lines with multiple vertices and is faster.

      • -

    • Fixes in the examples used to illustrate how od_dist() works.

      • -
    -
-
-

-stplanr 0.1.3

+

BUG FIXES

+

  • line2df() now works on lines with multiple vertices and is faster.

    • +

  • Fixes in the examples used to illustrate how od_dist() works.

    • +
+
+

stplanr 0.1.3

NEW FEATURES

-
    -

  • Update to OSRM functions to support API v5.

    • -

  • New parameter byvars in the overline() function, to allow disaggregation of results by a grouping variable (see example(overline)).

    • -

  • Faster implementation of od2line(): od2line2(). Plan is to replace the original if no issues are found with new implementation.

    • -

  • New function od2odf() which converts OD data into a dataframe of origins and destinations (feeds od2line2() but also useful as self-standing function).

    • +

    • Update to OSRM functions to support API v5.

      • +

    • New parameter byvars in the overline() function, to allow disaggregation of results by a grouping variable (see example(overline)).

      • +

    • Faster implementation of od2line(): od2line2(). Plan is to replace the original if no issues are found with new implementation.

      • +

    • New function od2odf() which converts OD data into a dataframe of origins and destinations (feeds od2line2() but also useful as self-standing function).

    • New argument new_proj in buff_geo() allows the results to be exported to any coordinate reference system (CRS).

    • New function gprojected() generalises concept of buff_geo(), building on crs_select_aeq() to allow any GIS query to be conducted on a temporary projected version of spatial objects with geographical CRSs.

      • -

    • New function od_dist() can quickly calculate Euclidean distances of OD pairs without converting to spatial objects.

      • -
    -

    BUG FIXES

    -
      -

    • Bug fix in onewayid() so it captures all lines.

      • +

    • New function od_dist() can quickly calculate Euclidean distances of OD pairs without converting to spatial objects.

      • +

    BUG FIXES

    +

    • Bug fix in onewayid() so it captures all lines.

    • Various improvements to documentation and code.

      • -
    -
-
-

-stplanr 0.1.2

+
+
+

stplanr 0.1.2

NEW FEATURES

-
    -

  • Interface to the Google Distance Matrix API with dist_google.

    • +

    • Interface to the Google Distance Matrix API with dist_google.

    • New transport planning API added, with route_transportapi_public (for testing).

    • Update to line2route, allowing it to accept different routing funtions via the new argument route_fun (for testing - tested with route_fun = route_cyclestreet).

    • New functions for creating origin-destination data frames (point2odf) and SpatialLinesDataFrames (points2flow).

    • Addition of n_vertices and is_linepoint for identifying the number of vertices in spatial objects and whether the ‘line’ is really a point.

      • -
    -

    BUG FIXES

    -
      -
    • +

    BUG FIXES

    +
    • line2route refactored, with 10 fold speed increases on large (1000+) batches of lines.
      • -
    -
-
-

-stplanr 0.1.0

+
+
+

stplanr 0.1.0

NEW FEATURES

-
    -

  • Addition of new class definition SpatialLinesNetwork, methods for plot and summary and functions calc_network_routes and find_network_nodes allowing fast route calculations via igraph and other network analysis functions.

    • +

    • Addition of new class definition SpatialLinesNetwork, methods for plot and summary and functions calc_network_routes and find_network_nodes allowing fast route calculations via igraph and other network analysis functions.

    • Functions for removing beginning and end of lines: toptail and toptailgs. Helper functions buff_geo, crs_select_aeq and line2points added.

    • Functionality for reading in the UK’s stats19 data: read_stats19_* functions download, unzip and re-categorise the data.

    • read_table functions added for reading Australian OD data.

    • decode_gl added to decode Google polylines and other functions for querying and reading data from OSRM services.

    • gtfs2sldf added to import GTFS routes as SpatialLinesDataFrames.

      • -
    -
-
-

-stplanr 0.0.2

-
    -
  • Published on CRAN
    • -
+
+
+

stplanr 0.0.2

+
  • Published on CRAN
    • +
- - + - - - - - + - - + + diff --git a/docs/pkgdown.yml b/docs/pkgdown.yml index 13cdd13b..fea39641 100644 --- a/docs/pkgdown.yml +++ b/docs/pkgdown.yml @@ -8,7 +8,7 @@ articles: stplanr-route-nets: stplanr-route-nets.html stplanr-routing: stplanr-routing.html stplanr: stplanr.html -last_built: 2022-11-08T00:28Z +last_built: 2022-11-13T22:50Z urls: reference: https://ropensci.github.io/stplanr/reference article: https://ropensci.github.io/stplanr/articles diff --git a/docs/reference/angle_diff.html b/docs/reference/angle_diff.html index 3114ffec..8ea0aca8 100644 --- a/docs/reference/angle_diff.html +++ b/docs/reference/angle_diff.html @@ -1,291 +1,194 @@ - - - - - - - -Calculate the angular difference between lines and a predefined bearing — angle_diff • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Calculate the angular difference between lines and a predefined bearing

- Source: R/linefuns.R - +
+

Calculate the angular difference between lines and a predefined bearing

+ Source: R/linefuns.R +
angle_diff.Rd
-
+

This function was designed to find lines that are close to parallel and perpendicular to some pre-defined route. It can return results that are absolute (contain information on the direction of turn, i.e. + or - values for clockwise/anticlockwise), bidirectional (which mean values greater than +/- 90 are impossible).

- 
angle_diff(l, angle, bidirectional = FALSE, absolute = TRUE)
+
+

Usage

+ 
angle_diff(l, angle, bidirectional = FALSE, absolute = TRUE)
+
-

Arguments

- - - - - - - - - - - - - - - - - - -
l

A spatial lines object

angle

an angle in degrees relative to North, with 90 being East and -90 being West. -(direction of rotation is ignored).

bidirectional

Should the result be returned in a bidirectional format? -Default is FALSE. If TRUE, the same line in the oposite direction would have the same bearing

absolute

If TRUE (the default) only positive values can be returned

+
+

Arguments

+
l
+

A spatial lines object

-

Details

-

Building on the convention used in bearing() and in many applications, -North is definied as 0, East as 90 and West as -90.

-

See also

+
angle
+

an angle in degrees relative to North, with 90 being East and -90 being West. +(direction of rotation is ignored).

-

Other lines: -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
# fails on some systems (with early versions of PROJ)
-if(lib_versions[3] >= "6.3.1") {
-  # Find all routes going North-South
-  lines_sf = od2line(od_data_sample, zones = zones_sf)
-  angle_diff(lines_sf[2, ], angle = 0)
-  angle_diff(lines_sf[2:3, ], angle = 0)
-  a <- angle_diff(flowlines, angle = 0, bidirectional = TRUE, absolute = TRUE)
-  plot(flowlines)
-  plot(flowlines[a < 15, ], add = TRUE, lwd = 3, col = "red")
-  # East-West
-  plot(flowlines[a > 75, ], add = TRUE, lwd = 3, col = "green")
-}
-
#> Creating centroids representing desire line start and end points.
-
- -
+
bidirectional
+

Should the result be returned in a bidirectional format? +Default is FALSE. If TRUE, the same line in the oposite direction would have the same bearing

+ +
absolute
+

If TRUE (the default) only positive values can be returned

-
- -
+
+
+

Details

+

Building on the convention used in in the bearing() function from the +geosphere package and in many applications, +North is definied as 0, East as 90 and West as -90.

+
+
+

See also

+

Other lines: +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
+ +
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+# fails on some systems (with early versions of PROJ)
+if (lib_versions[3] >= "6.3.1") {
+  # Find all routes going North-South
+  lines_sf <- od2line(od_data_sample, zones = zones_sf)
+  angle_diff(lines_sf[2, ], angle = 0)
+  angle_diff(lines_sf[2:3, ], angle = 0)
+}
+#> Creating centroids representing desire line start and end points.
+#> Linking to GEOS 3.10.2, GDAL 3.4.1, PROJ 8.2.1; sf_use_s2() is TRUE
+#> [1]  92.2313 105.0539
+
+
+
+ + + -
- +
+ - - + + diff --git a/docs/reference/bbox_scale-1.png b/docs/reference/bbox_scale-1.png index 90884e26f7aabf3d37972aed26973ba9769a64d2..3d9868b1a43b666d8f0c31bc763abca55f20038b 100644 GIT binary patch literal 23949 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 literal 23750 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 l;7 - - - - - - -Scale a bounding box — bbox_scale • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Scale a bounding box

- Source: R/geo-functions.R - +
+

Scale a bounding box

+ Source: R/geo-functions.R +
bbox_scale.Rd
-
+

Takes a bounding box as an input and outputs a bounding box of a different size, centred at the same point.

- 
bbox_scale(bb, scale_factor)
+
+

Usage

+ 
bbox_scale(bb, scale_factor)
+
-

Arguments

- - - - - - - - - - -
bb

the bounding box or spatial object that will be used to crop shp

scale_factor

Numeric vector determining how much the bounding box will grow or shrink. -Two numbers refer to extending the bounding box in x and y dimensions, respectively. -If the value is 1, the output size will be the same as the input.

+
+

Arguments

+
bb
+

Bounding box object

-

See also

-

Other geo: -gclip(), -geo_bb_matrix(), -geo_bb(), -mapshape_available(), -mapshape(), -quadrant(), -reproject()

+
scale_factor
+

Numeric vector determining how much the bounding box will grow or shrink. +Two numbers refer to extending the bounding box in x and y dimensions, respectively. +If the value is 1, the output size will be the same as the input.

+ +
+
+

See also

+

Other geo: +geo_bb_matrix(), +geo_bb(), +geo_buffer(), +geo_length(), +geo_projected(), +geo_select_aeq(), +quadrant()

+
-

Examples

- 
bb <- matrix(c(-1.55, 53.80, -1.50, 53.83), nrow = 2)
-bb1 <- bbox_scale(bb, scale_factor = 1.05)
-bb2 <- bbox_scale(bb, scale_factor = c(2, 1.05))
-bb3 <- bbox_scale(bb, 0.1)
-plot(x = bb2[1, ], y = bb2[2, ])
-
points(bb1[1, ], bb1[2, ])
-
points(bb3[1, ], bb3[2, ])
-
points(bb[1, ], bb[2, ], col = "red")
-
-
- -
+
+

Examples

+ 
bb <- matrix(c(-1.55, 53.80, -1.50, 53.83), nrow = 2)
+bb1 <- bbox_scale(bb, scale_factor = 1.05)
+bb2 <- bbox_scale(bb, scale_factor = c(2, 1.05))
+bb3 <- bbox_scale(bb, 0.1)
+plot(x = bb2[1, ], y = bb2[2, ])
+points(bb1[1, ], bb1[2, ])
+points(bb3[1, ], bb3[2, ])
+points(bb[1, ], bb[2, ], col = "red")
+
+
+
+
-
+ - - + + diff --git a/docs/reference/flow.html b/docs/reference/flow.html index 742435b9..a5165e15 100644 --- a/docs/reference/flow.html +++ b/docs/reference/flow.html @@ -1,172 +1,85 @@ - - - - - - - -data frame of commuter flows — flow • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

data frame of commuter flows

- Source: R/data.R - +
+

Data frame of commuter flows

+ Source: R/data.R +
flow.Rd
-
+

This dataset represents commuter flows (work travel) between origin -and destination zones (see cents()). +and destination zones. The data is from the UK and is available as open data: -https://wicid.ukdataservice.ac.uk/.

+https://wicid.ukdataservice.ac.uk/.

- 
data(flow)
- - -

Format

+
+

Format

A data frame with 49 rows and 15 columns

-

Details

- +
+
+

Details

The variables are as follows:

-
-
- -
+
-
+ - - + + diff --git a/docs/reference/flow_dests.html b/docs/reference/flow_dests.html index 89a13ab6..1beaf67a 100644 --- a/docs/reference/flow_dests.html +++ b/docs/reference/flow_dests.html @@ -1,247 +1,160 @@ - - - - - - - -data frame of invented -commuter flows with destinations in a different layer than the origins — flow_dests • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

data frame of invented +
+

Data frame of invented commuter flows with destinations in a different layer than the origins

- Source: R/data.R - + Source: R/data.R +
flow_dests.Rd
-
-

data frame of invented +

+

Data frame of invented commuter flows with destinations in a different layer than the origins

- 
data(flow_dests)
- - -

Format

+
+

Usage

+ 
data(flow_dests)
+
+
+

Format

A data frame with 49 rows and 15 columns

-

See also

- -

Other example data: -destination_zones, -flowlines, -flow, -route_network, -routes_fast, -routes_slow

- -

Examples

- 
if (FALSE) {
-# This is how the dataset was constructed
-flow_dests <- flow
-flow_dests$Area.of.workplace <- sample(x = destinations$WZ11CD, size = nrow(flow))
-flow_dests <- dplyr::rename(flow_dests, WZ11CD = Area.of.workplace)
-devtools::use_data(flow_dests)
-}
+    

+    

+    
See also

+    
Other data: 
+cents_sf,
+destinations_sf,
+flowlines_sf,
+flow,
+od_data_lines,
+od_data_routes,
+od_data_sample,
+osm_net_example,
+read_table_builder(),
+route_network_sf,
+route_network_small,
+routes_fast_sf,
+routes_slow_sf,
+zones_sf

+    

 
-
-
- -

+
+

Examples

+ 
if (FALSE) {
+# This is how the dataset was constructed
+flow_dests <- flow
+flow_dests$Area.of.workplace <- sample(x = destinations$WZ11CD, size = nrow(flow))
+flow_dests <- dplyr::rename(flow_dests, WZ11CD = Area.of.workplace)
+devtools::use_data(flow_dests)
+}
+
+
+
-
+ - - + + diff --git a/docs/reference/geo_bb-1.png b/docs/reference/geo_bb-1.png index b7aaf3558986d1250590f24a4aa4f463e25f9c39..7e6abd996d99858e2d3b58f372baa9f7475e29b8 100644 GIT binary patch literal 35460 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 diff --git a/docs/reference/geo_bb.html b/docs/reference/geo_bb.html index 52d79377..54c6f213 100644 --- a/docs/reference/geo_bb.html +++ b/docs/reference/geo_bb.html @@ -1,269 +1,181 @@ - - - - - - - -Flexible function to generate bounding boxes — geo_bb • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Flexible function to generate bounding boxes

- Source: R/geo-functions.R - +
+

Flexible function to generate bounding boxes

+ Source: R/geo-functions.R +
geo_bb.Rd
-
+

Takes a geographic object or bounding box as an input and outputs a bounding box, represented as a bounding box, corner points or rectangular polygon.

- 
geo_bb(
-  shp,
-  scale_factor = 1,
-  distance = 0,
-  output = c("polygon", "points", "bb")
-)
+
+

Usage

+ 
geo_bb(
+  shp,
+  scale_factor = 1,
+  distance = 0,
+  output = c("polygon", "points", "bb")
+)
+
+ +
+

Arguments

+
shp
+

Spatial object

-

Arguments

- - - - - - - - - - - - - - - - - - -
shp

Spatial object (from sf or sp packages)

scale_factor

Numeric vector determining how much the bounding box will grow or shrink. + +

scale_factor
+

Numeric vector determining how much the bounding box will grow or shrink. Two numbers refer to extending the bounding box in x and y dimensions, respectively. -If the value is 1, the output size will be the same as the input.

distance

Distance in metres to extend the bounding box by

output

Type of object returned (polygon by default)

+If the value is 1, the output size will be the same as the input.

+ + +
distance
+

Distance in metres to extend the bounding box by

-

See also

-

bb_scale

+
output
+

Type of object returned (polygon by default)

+ +
+
+

See also

+

bb_scale

Other geo: -bbox_scale(), -gclip(), -geo_bb_matrix(), -mapshape_available(), -mapshape(), -quadrant(), -reproject()

+bbox_scale(), +geo_bb_matrix(), +geo_buffer(), +geo_length(), +geo_projected(), +geo_select_aeq(), +quadrant()

+
-

Examples

- 
# Simple features implementation:
-shp <- routes_fast_sf
-shp_bb <- geo_bb(shp, distance = 100)
-
#> Assuming a geographical (lat/lon) CRS (EPSG:4326)
#> Transforming to CRS +proj=aeqd +lat_0=53.816446 +lon_0=-1.5309755 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs
#> Warning: CRS object has comment, which is lost in output
plot(shp_bb, col = "red", reset = FALSE)
-
plot(geo_bb(routes_fast_sf, scale_factor = 0.8), col = "green", add = TRUE)
-
plot(geo_bb(routes_fast_sf, output = "points"), add = TRUE)
-
plot(routes_fast_sf$geometry, add = TRUE)
-
-
- -
+
+

Examples

+ 
shp <- routes_fast_sf
+shp_bb <- geo_bb(shp, distance = 100)
+plot(shp_bb, col = "red", reset = FALSE)
+plot(geo_bb(routes_fast_sf, scale_factor = 0.8), col = "green", add = TRUE)
+plot(routes_fast_sf$geometry, add = TRUE)
+
+geo_bb(shp, output = "point")
+#> Geometry set for 4 features 
+#> Geometry type: POINT
+#> Dimension:     XY
+#> Bounding box:  xmin: -1.550964 ymin: 53.80248 xmax: -1.510987 ymax: 53.83041
+#> Geodetic CRS:  WGS 84
+#> POINT (-1.550964 53.80248)
+#> POINT (-1.510987 53.80248)
+#> POINT (-1.510987 53.83041)
+#> POINT (-1.550964 53.83041)
+
+
+
-
+ - - + + diff --git a/docs/reference/geo_bb_matrix.html b/docs/reference/geo_bb_matrix.html index a7f2691f..7d913730 100644 --- a/docs/reference/geo_bb_matrix.html +++ b/docs/reference/geo_bb_matrix.html @@ -1,255 +1,158 @@ - - - - - - - -Create matrix representing the spatial bounds of an object — geo_bb_matrix • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Create matrix representing the spatial bounds of an object

- Source: R/geo-functions.R - +
+

Create matrix representing the spatial bounds of an object

+ Source: R/geo-functions.R +
geo_bb_matrix.Rd
-
+

Converts a range of spatial data formats into a matrix representing the bounding box

- 
geo_bb_matrix(shp)
- -

Arguments

- - - - - - -
shp

Spatial object (from sf or sp packages)

- -

See also

+
+

Usage

+ 
geo_bb_matrix(shp)
+
-

Other geo: -bbox_scale(), -gclip(), -geo_bb(), -mapshape_available(), -mapshape(), -quadrant(), -reproject()

+
+

Arguments

+
shp
+

Spatial object

+ +
+
+

See also

+

Other geo: +bbox_scale(), +geo_bb(), +geo_buffer(), +geo_length(), +geo_projected(), +geo_select_aeq(), +quadrant()

+
-

Examples

- 
geo_bb_matrix(routes_fast)
-
#>         min       max
-#> x -1.550807 -1.511861
-#> y 53.804098 53.828874
geo_bb_matrix(routes_fast_sf)
-
#>           [,1]      [,2]
-#> [1,] -1.550964 -1.510987
-#> [2,] 53.802478 53.830414
geo_bb_matrix(cents[1, ])
-
#>                 min       max
-#> coords.x1 -1.546463 -1.546463
-#> coords.x2 53.809517 53.809517
geo_bb_matrix(c(-2, 54))
-
#>      [,1] [,2]
-#> [1,]   -2   -2
-#> [2,]   54   54
geo_bb_matrix(sf::st_coordinates(cents_sf))
-
#>           [,1]      [,2]
-#> [1,] -1.550806 -1.511861
-#> [2,] 53.804098 53.828874
-
- -
+
+

Examples

+ 
geo_bb_matrix(routes_fast_sf)
+#>           [,1]      [,2]
+#> [1,] -1.550964 -1.510987
+#> [2,] 53.802478 53.830414
+geo_bb_matrix(cents_sf[1, ])
+#>           [,1]      [,2]
+#> [1,] -1.546463 -1.546463
+#> [2,] 53.809517 53.809517
+geo_bb_matrix(c(-2, 54))
+#>      [,1] [,2]
+#> [1,]   -2   -2
+#> [2,]   54   54
+geo_bb_matrix(sf::st_coordinates(cents_sf))
+#>           [,1]      [,2]
+#> [1,] -1.550806 -1.511861
+#> [2,] 53.804098 53.828874
+
+
+
-
+ - - + + diff --git a/docs/reference/geo_buffer.html b/docs/reference/geo_buffer.html index 4d51ac49..8a8e2591 100644 --- a/docs/reference/geo_buffer.html +++ b/docs/reference/geo_buffer.html @@ -1,262 +1,187 @@ - - - - - - - -Perform a buffer operation on a temporary projected CRS — geo_buffer • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Perform a buffer operation on a temporary projected CRS

- Source: R/geo_projected.R - +
+

Perform a buffer operation on a temporary projected CRS

+ Source: R/geo_projected.R +
geo_buffer.Rd
-
+

This function solves the problem that buffers will not be circular when used on non-projected data.

- 
geo_buffer(shp, dist = NULL, width = NULL, ...)
+
+

Usage

+ 
geo_buffer(shp, dist = NULL, width = NULL, ...)
+
+ +
+

Arguments

+
shp
+

A spatial object with a geographic CRS (e.g. WGS84) +around which a buffer should be drawn

+ + +
dist
+

The distance (in metres) of the buffer (when buffering simple features)

+ + +
width
+

The distance (in metres) of the buffer (when buffering sp objects)

-

Arguments

- - - - - - - - - - - - - - - - - - -
shp

A spatial object with a geographic CRS (e.g. WGS84) -around which a buffer should be drawn

dist

The distance (in metres) of the buffer (when buffering simple features)

width

The distance (in metres) of the buffer (when buffering sp objects)

...

Arguments passed to the buffer (see ?rgeos::gBuffer or ?sf::st_buffer for details)

-

Details

+
...
+

Arguments passed to the buffer (see ?sf::st_buffer for details)

+
+
+

Details

Requires recent version of PROJ (>= 6.3.0). Buffers on sf objects with geographic (lon/lat) coordinates can also -be done with the s2 package.

+be done with the s2 package.

+
+
+

See also

+

Other geo: +bbox_scale(), +geo_bb_matrix(), +geo_bb(), +geo_length(), +geo_projected(), +geo_select_aeq(), +quadrant()

+
-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
if(lib_versions[3] >= "6.3.1") {
-  buff_sf <- geo_buffer(routes_fast_sf, dist = 50)
-  plot(buff_sf$geometry, add = TRUE)
-  geo_buffer(routes_fast_sf$geometry, dist = 50)
-  # on legacy sp objects (not tested)
-  buff_sp <- geo_buffer(routes_fast, width = 100)
-  class(buff_sp)
-  plot(buff_sp, col = "red")
-}
-
#> Error in polypath(p_bind(x[[i]]), border = border[i], lty = lty[i], lwd = lwd[i],     col = col[i], rule = rule): plot.new has not been called yet
-
- -
+
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+if (lib_versions[3] >= "6.3.1") {
+  buff_sf <- geo_buffer(routes_fast_sf, dist = 50)
+  plot(buff_sf$geometry)
+  geo_buffer(routes_fast_sf$geometry, dist = 50)
+}
+
+#> Geometry set for 49 features 
+#> Geometry type: POLYGON
+#> Dimension:     XY
+#> Bounding box:  xmin: -1.551723 ymin: 53.80203 xmax: -1.510228 ymax: 53.83086
+#> Geodetic CRS:  WGS 84
+#> First 5 geometries:
+#> POLYGON ((-1.515974 53.82887, -1.515975 53.8288...
+#> POLYGON ((-1.535569 53.82873, -1.535517 53.8287...
+#> POLYGON ((-1.550723 53.82451, -1.550871 53.8248...
+#> POLYGON ((-1.530548 53.81706, -1.530586 53.8170...
+#> POLYGON ((-1.518697 53.81731, -1.51892 53.81742...
+
+
+
-
+ - - + + diff --git a/docs/reference/geo_code.html b/docs/reference/geo_code.html index 6970df44..3ce9cea0 100644 --- a/docs/reference/geo_code.html +++ b/docs/reference/geo_code.html @@ -1,265 +1,161 @@ - - - - - - - -Convert text strings into points on the map — geo_code • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert text strings into points on the map

- Source: R/geo_code.R - +
+

Convert text strings into points on the map

+ Source: R/geo_code.R +
geo_code.Rd
-
+

Generate a lat/long pair from data using Google's geolocation API.

- 
geo_code(
-  address,
-  service = "nominatim",
-  base_url = "https://maps.google.com/maps/api/geocode/json",
-  return_all = FALSE,
-  pat = NULL
-)
+
+

Usage

+ 
geo_code(
+  address,
+  service = "nominatim",
+  base_url = "https://maps.google.com/maps/api/geocode/json",
+  return_all = FALSE,
+  pat = NULL
+)
+
-

Arguments

- - - - - - - - - - - - - - - - - - - - - - -
address

Text string representing the address you want to geocode

service

Which service to use? Nominatim by default

base_url

The base url to query

return_all

Should the request return all information returned by Google Maps? -The default is FALSE: to return only two numbers: the longitude and latitude, in that order

pat

The API key used. By default this is set to NULL and -this is usually aquired automatically through a helper, api_pat().

+
+

Arguments

+
address
+

Text string representing the address you want to geocode

-

See also

-

Other nodes: -nearest_google()

+
service
+

Which service to use? Nominatim by default

+ + +
base_url
+

The base url to query

-

Examples

- 
if (FALSE) {
-geo_code(address = "Hereford")
-geo_code("LS7 3HB")
-geo_code("hereford", return_all = TRUE)
-# needs api key in .Renviron
-geo_code("hereford", service = "google", pat = Sys.getenv("GOOGLE"), return_all = TRUE)
-}
-
-
- -
+
return_all
+

Should the request return all information returned by Google Maps? +The default is FALSE: to return only two numbers: the longitude and latitude, in that order

-
- -
+ +
pat
+

Personal access token

+ +
+ +
+

Examples

+ 
if (FALSE) {
+geo_code(address = "Hereford")
+geo_code("LS7 3HB")
+geo_code("hereford", return_all = TRUE)
+# needs api key in .Renviron
+geo_code("hereford", service = "google", pat = Sys.getenv("GOOGLE"), return_all = TRUE)
+}
+
+
+
+ + + -
- +
+ - - + + diff --git a/docs/reference/geo_length.html b/docs/reference/geo_length.html index 0df833da..fd278f83 100644 --- a/docs/reference/geo_length.html +++ b/docs/reference/geo_length.html @@ -1,245 +1,161 @@ - - - - - - - -Calculate line length of line with geographic or projected CRS — geo_length • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Calculate line length of line with geographic or projected CRS

- Source: R/geo_projected.R - +
+

Calculate line length of line with geographic or projected CRS

+ Source: R/geo_projected.R +
geo_length.Rd
-
+

Takes a line (represented in sf or sp classes) and returns a numeric value representing distance in meters.

- 
geo_length(shp)
- -

Arguments

- - - - - - -
shp

A spatial line object

+
+

Usage

+ 
geo_length(shp)
+
+
+

Arguments

+
shp
+

A spatial line object

+ +
+
+

See also

+

Other geo: +bbox_scale(), +geo_bb_matrix(), +geo_bb(), +geo_buffer(), +geo_projected(), +geo_select_aeq(), +quadrant()

+
-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
if(lib_versions[3] >= "6.3.1") {
-  geo_length(routes_fast)
-  geo_length(routes_fast_sf)
-}
-
#>  [1]    0.0000 1538.8810 2990.7783 2297.5929 1870.2117 2239.1301 3352.8345
-#>  [8] 1538.8810    0.0000 1580.7084 1506.1390 2483.2391 3156.1339 3877.7765
-#> [15] 2992.2337 1708.4876    0.0000 2121.8359 3098.9361 3768.5096 3711.6150
-#> [22] 2366.0647 1506.1390 2078.5604    0.0000  977.1004 1646.6739 2371.6377
-#> [29] 1875.7200 2483.2391 3055.6605  977.1004    0.0000  872.9039 1727.9827
-#> [36] 2239.4037 3085.7290 3725.2340 1646.6739  872.9039    0.0000 1303.2590
-#> [43] 3285.0306 3829.5751 3868.1338 2323.4363 1727.9827 1303.2590    0.0000
-
- -
+
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+if (lib_versions[3] >= "6.3.1") {
+  geo_length(routes_fast_sf)
+}
+#>  [1]    0.0000 1538.8810 2990.7783 2297.5929 1870.2117 2239.1301 3352.8345
+#>  [8] 1538.8810    0.0000 1580.7084 1506.1390 2483.2391 3156.1339 3877.7765
+#> [15] 2992.2337 1708.4876    0.0000 2121.8359 3098.9361 3768.5096 3711.6150
+#> [22] 2366.0647 1506.1390 2078.5604    0.0000  977.1004 1646.6739 2371.6377
+#> [29] 1875.7200 2483.2391 3055.6605  977.1004    0.0000  872.9039 1727.9827
+#> [36] 2239.4037 3085.7290 3725.2340 1646.6739  872.9039    0.0000 1303.2590
+#> [43] 3285.0306 3829.5751 3868.1338 2323.4363 1727.9827 1303.2590    0.0000
+
+
+
-
+ - - + + diff --git a/docs/reference/geo_projected.html b/docs/reference/geo_projected.html index 67251fba..8e4c80cf 100644 --- a/docs/reference/geo_projected.html +++ b/docs/reference/geo_projected.html @@ -1,271 +1,187 @@ - - - - - - - -Perform GIS functions on a temporary, projected version of a spatial object — geo_projected • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Perform GIS functions on a temporary, projected version of a spatial object

- Source: R/geo_projected.R - +
+

Perform GIS functions on a temporary, projected version of a spatial object

+ Source: R/geo_projected.R +
geo_projected.Rd
-
+

This function performs operations on projected data.

- 
geo_projected(shp, fun, crs, silent, ...)
+
+

Usage

+ 
geo_projected(shp, fun, crs, silent, ...)
+
-

Arguments

- - - - - - - - - - - - - - - - - - - - - - -
shp

A spatial object with a geographic (WGS84) coordinate system

fun

A function to perform on the projected object (e.g. the the rgeos or sf packages)

crs

An optional coordinate reference system (if not provided it is set -automatically by geo_select_aeq())

silent

A binary value for printing the CRS details (default: TRUE)

...

Arguments to pass to fun, e.g. byid = TRUE if the function is rgeos::gLength()

+
+

Arguments

+
shp
+

A spatial object with a geographic (WGS84) coordinate system

-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
# fails on some systems (with early versions of PROJ)
-if(lib_versions[3] >= "6.3.1") {
-  shp <- routes_fast_sf[2:4, ]
-  geo_projected(shp, sf::st_buffer, dist = 100)
-}
-
#> Simple feature collection with 3 features and 16 fields
-#> geometry type:  POLYGON
-#> dimension:      XY
-#> bbox:           xmin: -1.552483 ymin: 53.81661 xmax: -1.511078 ymax: 53.83131
-#> geographic CRS: WGS 84
-#>   plan start finish length time waypoint cum_hill change_elev dif_max_min
-#> 2    1     1      1   1535  464       53       87          -7          39
-#> 3    1     1      1   2976  829       97      112          -4          39
-#> 4    1     1      1   2290  502       37      103         -45          65
-#>   up_tot down_tot av_incline co2_saving calories busyness ID
-#> 2     40       47 0.05667752        286       52     3327  2
-#> 3     54       58 0.03763441        555       78     7062  3
-#> 4     29       74 0.04497817        427       38     3380  4
-#>                         geometry
-#> 2 POLYGON ((-1.535639 53.8292...
-#> 3 POLYGON ((-1.551653 53.8248...
-#> 4 POLYGON ((-1.530458 53.8166...
-
- -
+
fun
+

A function to perform on the projected object (e.g. from the sf package)

+ + +
crs
+

An optional coordinate reference system (if not provided it is set +automatically by geo_select_aeq())

+ +
silent
+

A binary value for printing the CRS details (default: TRUE)

-
- -
+ +
...
+

Arguments to pass to fun

+ +
+
+

See also

+

Other geo: +bbox_scale(), +geo_bb_matrix(), +geo_bb(), +geo_buffer(), +geo_length(), +geo_select_aeq(), +quadrant()

+
+ +
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+# fails on some systems (with early versions of PROJ)
+if (lib_versions[3] >= "6.3.1") {
+  shp <- routes_fast_sf[2:4, ]
+  geo_projected(shp, sf::st_buffer, dist = 100)
+}
+#> Simple feature collection with 3 features and 16 fields
+#> Geometry type: POLYGON
+#> Dimension:     XY
+#> Bounding box:  xmin: -1.552483 ymin: 53.81661 xmax: -1.511078 ymax: 53.83131
+#> Geodetic CRS:  WGS 84
+#>   plan start finish length time waypoint cum_hill change_elev dif_max_min
+#> 2    1     1      1   1535  464       53       87          -7          39
+#> 3    1     1      1   2976  829       97      112          -4          39
+#> 4    1     1      1   2290  502       37      103         -45          65
+#>   up_tot down_tot av_incline co2_saving calories busyness ID
+#> 2     40       47 0.05667752        286       52     3327  2
+#> 3     54       58 0.03763441        555       78     7062  3
+#> 4     29       74 0.04497817        427       38     3380  4
+#>                         geometry
+#> 2 POLYGON ((-1.535639 53.8292...
+#> 3 POLYGON ((-1.551653 53.8248...
+#> 4 POLYGON ((-1.530458 53.8166...
+
+
+
+ + + -
- +
+ - - + + diff --git a/docs/reference/geo_select_aeq.html b/docs/reference/geo_select_aeq.html index f7ac0676..1c11d4a6 100644 --- a/docs/reference/geo_select_aeq.html +++ b/docs/reference/geo_select_aeq.html @@ -1,287 +1,194 @@ - - - - - - - -Select a custom projected CRS for the area of interest — geo_select_aeq • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Select a custom projected CRS for the area of interest

- Source: R/geo_projected.R - +
+

Select a custom projected CRS for the area of interest

+ Source: R/geo_projected.R +
geo_select_aeq.Rd
-
+

This function takes a spatial object with a geographic (WGS84) CRS and returns a custom projected CRS focussed on the centroid of the object. This function is especially useful for using units of metres in all directions for data collected anywhere in the world.

- 
geo_select_aeq(shp)
- -

Arguments

- - - - - - -
shp

A spatial object with a geographic (WGS84) coordinate system

+
+

Usage

+ 
geo_select_aeq(shp)
+
-

Details

+
+

Arguments

+
shp
+

A spatial object with a geographic (WGS84) coordinate system

+
+
+

Details

The function is based on this stackexchange answer: -https://gis.stackexchange.com/questions/121489

+https://gis.stackexchange.com/questions/121489

+
+
+

See also

+

Other geo: +bbox_scale(), +geo_bb_matrix(), +geo_bb(), +geo_buffer(), +geo_length(), +geo_projected(), +quadrant()

+
-

Examples

- 
sp::bbox(routes_fast)
-
#>         min       max
-#> x -1.550807 -1.511861
-#> y 53.804098 53.828874
new_crs <- geo_select_aeq(routes_fast)
-rf_projected <- sp::spTransform(routes_fast, new_crs)
-sp::bbox(rf_projected)
-
#>         min      max
-#> x -1545.979 1086.642
-#> y -1833.567 1275.756
line_length <- rgeos::gLength(rf_projected, byid = TRUE)
-plot(line_length, rf_projected$length)
-
shp <- zones_sf
-geo_select_aeq(shp)
-
#> Coordinate Reference System:
-#>   User input: +proj=aeqd +lat_0=53.8183052800959 +lon_0=-1.53014431833907 +x_0=0 +y_0=0 
-#>   wkt:
-#> PROJCRS["unknown",
-#>     BASEGEOGCRS["unknown",
-#>         DATUM["World Geodetic System 1984",
-#>             ELLIPSOID["WGS 84",6378137,298.257223563,
-#>                 LENGTHUNIT["metre",1]],
-#>             ID["EPSG",6326]],
-#>         PRIMEM["Greenwich",0,
-#>             ANGLEUNIT["degree",0.0174532925199433],
-#>             ID["EPSG",8901]]],
-#>     CONVERSION["unknown",
-#>         METHOD["Modified Azimuthal Equidistant",
-#>             ID["EPSG",9832]],
-#>         PARAMETER["Latitude of natural origin",53.8183052800959,
-#>             ANGLEUNIT["degree",0.0174532925199433],
-#>             ID["EPSG",8801]],
-#>         PARAMETER["Longitude of natural origin",-1.53014431833907,
-#>             ANGLEUNIT["degree",0.0174532925199433],
-#>             ID["EPSG",8802]],
-#>         PARAMETER["False easting",0,
-#>             LENGTHUNIT["metre",1],
-#>             ID["EPSG",8806]],
-#>         PARAMETER["False northing",0,
-#>             LENGTHUNIT["metre",1],
-#>             ID["EPSG",8807]]],
-#>     CS[Cartesian,2],
-#>         AXIS["(E)",east,
-#>             ORDER[1],
-#>             LENGTHUNIT["metre",1,
-#>                 ID["EPSG",9001]]],
-#>         AXIS["(N)",north,
-#>             ORDER[2],
-#>             LENGTHUNIT["metre",1,
-#>                 ID["EPSG",9001]]]]
-
- -
+
+

Examples

+ 
shp <- zones_sf
+geo_select_aeq(shp)
+#> Coordinate Reference System:
+#>   User input: +proj=aeqd +lat_0=53.8183052800959 +lon_0=-1.53014431833907 +x_0=0 +y_0=0 
+#>   wkt:
+#> PROJCRS["unknown",
+#>     BASEGEOGCRS["unknown",
+#>         DATUM["World Geodetic System 1984",
+#>             ELLIPSOID["WGS 84",6378137,298.257223563,
+#>                 LENGTHUNIT["metre",1]],
+#>             ID["EPSG",6326]],
+#>         PRIMEM["Greenwich",0,
+#>             ANGLEUNIT["degree",0.0174532925199433],
+#>             ID["EPSG",8901]]],
+#>     CONVERSION["unknown",
+#>         METHOD["Modified Azimuthal Equidistant",
+#>             ID["EPSG",9832]],
+#>         PARAMETER["Latitude of natural origin",53.8183052800959,
+#>             ANGLEUNIT["degree",0.0174532925199433],
+#>             ID["EPSG",8801]],
+#>         PARAMETER["Longitude of natural origin",-1.53014431833907,
+#>             ANGLEUNIT["degree",0.0174532925199433],
+#>             ID["EPSG",8802]],
+#>         PARAMETER["False easting",0,
+#>             LENGTHUNIT["metre",1],
+#>             ID["EPSG",8806]],
+#>         PARAMETER["False northing",0,
+#>             LENGTHUNIT["metre",1],
+#>             ID["EPSG",8807]]],
+#>     CS[Cartesian,2],
+#>         AXIS["(E)",east,
+#>             ORDER[1],
+#>             LENGTHUNIT["metre",1,
+#>                 ID["EPSG",9001]]],
+#>         AXIS["(N)",north,
+#>             ORDER[2],
+#>             LENGTHUNIT["metre",1,
+#>                 ID["EPSG",9001]]]]
+
+
+
-
+ - - + + diff --git a/docs/reference/geo_toptail.html b/docs/reference/geo_toptail.html index 30cb9e2f..5bbcc380 100644 --- a/docs/reference/geo_toptail.html +++ b/docs/reference/geo_toptail.html @@ -1,281 +1,184 @@ - - - - - - - -Clip the first and last n metres of SpatialLines — geo_toptail • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Clip the first and last n metres of SpatialLines

- Source: R/toptail.R - +
+

Clip the first and last n metres of SpatialLines

+ Source: R/toptail.R +
geo_toptail.Rd
-
+

Takes lines and removes the start and end point, to a distance determined by the user.

- 
geo_toptail(l, toptail_dist, ...)
+
+

Usage

+ 
geo_toptail(l, toptail_dist, ...)
+
+ +
+

Arguments

+
l
+

An sf object representing lines

-

Arguments

- - - - - - - - - - - - - - -
l

A SpatialLines object

toptail_dist

The distance (in metres) to top and tail the line by. + +

toptail_dist
+

The distance (in metres) to top and tail the line by. Can either be a single value or a vector of the same length as the -SpatialLines object.

...

Arguments passed to rgeos::gBuffer()

+SpatialLines object.

-

Details

-

Note: toptailgs() is around 10 times faster, but only works -on data with geographic CRS's due to its reliance on the geosphere -package.

-

See also

+
...
+

Arguments passed to sf::st_buffer()

-

Other lines: -angle_diff(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+
+

Details

+

Note: see the function +toptailgs() +in stplanr v0.8.5 for an implementation that uses the geosphere +package.

+
+
+

See also

+

Other lines: +angle_diff(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
# dont test due to issues with sp classes on some set-ups
-if(lib_versions[3] >= "6.3.1") {
-  # l <- routes_fast[2:4, ] # to run with sp classes
-  l <- routes_fast_sf[2:4, ]
-  l_top_tail <- geo_toptail(l, 300)
-  l_top_tail
-  plot(sf::st_geometry(l_top_tail))
-  plot(sf::st_geometry(geo_toptail(l, 600)), lwd = 9, add = TRUE)
-}
-
-
- -
+
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+# dont test due to issues with sp classes on some set-ups
+if (lib_versions[3] >= "6.3.1") {
+  l <- routes_fast_sf[2:4, ]
+  l_top_tail <- geo_toptail(l, 300)
+  l_top_tail
+  plot(sf::st_geometry(l_top_tail))
+  plot(sf::st_geometry(geo_toptail(l, 600)), lwd = 9, add = TRUE)
+}
+
+
+
+
-
+ - - + + diff --git a/docs/reference/gsection.html b/docs/reference/gsection.html index e5185db1..975c1073 100644 --- a/docs/reference/gsection.html +++ b/docs/reference/gsection.html @@ -1,280 +1,169 @@ - - - - - - - -Function to split overlapping SpatialLines into segments — gsection • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Function to split overlapping SpatialLines into segments

- Source: R/overline.R - +
+

Function to split overlapping SpatialLines into segments

+ Source: R/overline.R +
gsection.Rd
-
+

Divides SpatialLinesDataFrame objects into separate Lines. Each new Lines object is the aggregate of a single number of aggregated lines.

- 
gsection(sl, buff_dist = 0)
- -

Arguments

- - - - - - - - - - -
sl

SpatialLinesDataFrame with overlapping Lines to split by -number of overlapping features.

buff_dist

A number specifying the distance in meters of the buffer to be used to crop lines before running the operation. -If the distance is zero (the default) touching but non-overlapping lines may be aggregated.

- -

See also

+
+

Usage

+ 
gsection(sl, buff_dist = 0)
+
-

Other rnet: -SpatialLinesNetwork, -calc_catchment_sum(), -calc_catchment(), -calc_moving_catchment(), -calc_network_catchment(), -find_network_nodes(), -islines(), -lineLabels(), -overline_spatial(), -overline(), -plot,SpatialLinesNetwork,ANY-method, -plot,sfNetwork,ANY-method, -rnet_breakup_vertices(), -rnet_group(), -sln2points(), -sum_network_links(), -sum_network_routes()

+
+

Arguments

+
sl
+

SpatialLinesDataFrame with overlapping Lines to split by +number of overlapping features.

+ + +
buff_dist
+

A number specifying the distance in meters of the buffer to be used to crop lines before running the operation. +If the distance is zero (the default) touching but non-overlapping lines may be aggregated.

+ +
+
+

See also

+

Other rnet: +islines(), +overline(), +rnet_breakup_vertices(), +rnet_group()

+
-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
# fails on some systems (with early versions of PROJ)
-if(lib_versions[3] >= "6.3.1") {
-  sl <- routes_fast_sf[2:4, ]
-  rsec <- gsection(sl)
-  length(rsec) # sections
-  plot(rsec, col = seq(length(rsec)))
-  rsec <- gsection(sl, buff_dist = 50)
-  length(rsec) # 4 features: issue
-  plot(rsec, col = seq(length(rsec)))
-  # dont test due to issues with sp classes on some set-ups
-  # sl <- routes_fast[2:4, ]
-  # rsec <- gsection(sl)
-  # rsec_buff <- gsection(sl, buff_dist = 1)
-  # plot(sl[1], lwd = 9, col = 1:nrow(sl))
-  # plot(rsec, col = 5 + (1:length(rsec)), add = TRUE, lwd = 3)
-  # plot(rsec_buff, col = 5 + (1:length(rsec_buff)), add = TRUE, lwd = 3)
-}
-
-
- -
+
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+# fails on some systems (with early versions of PROJ)
+if (lib_versions[3] >= "6.3.1") {
+  sl <- routes_fast_sf[2:4, ]
+  rsec <- gsection(sl)
+  length(rsec) # sections
+  plot(rsec, col = seq(length(rsec)))
+  rsec <- gsection(sl, buff_dist = 50)
+  length(rsec) # 4 features: issue
+  plot(rsec, col = seq(length(rsec)))
+}
+
+
+
+
+
-
+ - - + + diff --git a/docs/reference/index.html b/docs/reference/index.html index cdd63cdb..47b44aaa 100644 --- a/docs/reference/index.html +++ b/docs/reference/index.html @@ -1,794 +1,673 @@ - - - - - - - -Function reference • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Reference

+
+

Function reference

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Work with OD data

-

-
-

dist_google()

-

Return travel network distances and time using the Google Maps API

-

od2line() od2line2()

-

Convert origin-destination data to spatial lines

-

od2odf()

-

Extract coordinates from OD data

-

od_aggregate_from()

-

Summary statistics of trips originating from zones in OD data

-

od_aggregate_to()

-

Summary statistics of trips arriving at destination zones in OD data

-

od_coords()

-

Create matrices representing origin-destination coordinates

-

od_coords2line()

-

Convert origin-destination coordinates into desire lines

-

od_dist()

-

Quickly calculate Euclidean distances of od pairs

-

od_id_szudzik() od_id_max_min() od_id_character()

-

Combine two ID values to create a single ID number

-

od_oneway()

-

Aggregate od pairs they become non-directional

-

od_to_odmatrix()

-

Convert origin-destination data from long to wide format

-

odmatrix_to_od()

-

Convert origin-destination data from wide to long format

-

points2flow()

-

Convert a series of points into geographical flows

-

points2odf()

-

Convert a series of points into a dataframe of origins and destinations

-

Work with (desire) lines

-

-
-

angle_diff()

-

Calculate the angular difference between lines and a predefined bearing

-

geo_toptail()

-

Clip the first and last n metres of SpatialLines

-

is_linepoint()

-

Identify lines that are points

-

line2df()

-

Convert geographic line objects to a data.frame with from and to coords

-

line2points() line2pointsn() line2vertices()

-

Convert a spatial (linestring) object to points

-

line_bearing()

-

Find the bearing of straight lines

-

line_breakup()

-

Break up line objects into shorter segments

-

line_match()

-

Match two sets of lines based on similarity

-

line_midpoint()

-

Find the mid-point of lines

-

line_sample()

-

Sample n points along lines with density proportional to a weight

-

line_segment()

-

Divide SpatialLines dataset into regular segments

-

line_via()

-

Add geometry columns representing a route via intermediary points

-

mats2line()

-

Convert 2 matrices to lines

-

n_sample_length()

-

Sample integer number from given continuous vector of line lengths and probabilities, with total n

-

n_vertices()

-

Retrieve the number of vertices from a SpatialLines or SpatialPolygons object

-

onewaygeo()

-

Aggregate flows so they become non-directional (by geometry - the slow way)

-

points2line()

-

Convert a series of points, or a matrix of coordinates, into a line

-

toptail_buff()

-

Clip the beginning and ends SpatialLines to the edge of SpatialPolygon borders

-

toptailgs()

-

Clip the first and last n metres of SpatialLines

-

update_line_geometry()

-

Update line geometry

-

Work with and analyse routes

-

-
-

route_average_gradient()

-

Return average gradient across a route

-

route_rolling_average()

-

Return smoothed averages of vector

-

route_rolling_diff()

-

Return smoothed differences between vector values

-

route_rolling_gradient()

-

Calculate rolling average gradient from elevation data at segment level

-

route_sequential_dist()

-

Calculate the sequential distances between sequential coordinate pairs

-

route_slope_matrix()

-

Calculate the gradient of line segments from a matrix of coordinates

-

route_slope_vector()

-

Calculate the gradient of line segments from distance and elevation vectors

-

Routing

-

-
-

line2route()

-

Convert straight OD data (desire lines) into routes

-

line2routeRetry()

-

Convert straight spatial (linestring) object from flow data into routes retrying -on connection (or other) intermittent failures

-

route()

-

Plan routes on the transport network

-

route_dodgr()

-

Route on local data using the dodgr package

-

route_local()

-

Plan a route with local data

-

route_transportapi_public()

-

Plan a single route with TransportAPI.com

-

Work with nodes

-

-
-

geo_code()

-

Convert text strings into points on the map

-

nearest_google()

-

Generate nearest point on the route network of a point using the Google Maps API

-

Route network functions

-

-
-

SpatialLinesNetwork()

-

Create object of class SpatialLinesNetwork or sfNetwork

-

calc_catchment()

-

Calculate catchment area and associated summary statistics.

-

calc_catchment_sum()

-

Calculate summary statistics for catchment area.

-

calc_moving_catchment()

-

Calculate summary statistics for all features independently.

-

calc_network_catchment()

-

Calculate catchment area and associated summary statistics using network.

-

find_network_nodes()

-

Find graph node ID of closest node to given coordinates

-

gsection()

-

Function to split overlapping SpatialLines into segments

-

islines()

-

Do the intersections between two geometries create lines?

-

lineLabels()

-

Label SpatialLinesDataFrame objects

-

overline() overline2()

-

Convert series of overlapping lines into a route network

-

overline_spatial()

-

Spatial aggregation of routes represented with sp classes

-

plot(<SpatialLinesNetwork>,<ANY>)

-

Plot a SpatialLinesNetwork

-

plot(<sfNetwork>,<ANY>)

-

Plot an sfNetwork

-

rnet_breakup_vertices()

-

Break up an sf object with LINESTRING geometry.

-

rnet_group()

-

Assign segments in a route network to groups

-

sln2points()

-

Generate spatial points representing nodes on a SpatialLinesNetwork -or sfNetwork.

-

sum_network_links()

-

Summarise links from shortest paths data

-

sum_network_routes()

-

Summarise shortest path between nodes on network

-

Geographic functions

-

-
-

bbox_scale()

-

Scale a bounding box

-

gclip()

-

Crops spatial object x to the bounding box of spatial object (or matrix) b

-

geo_bb()

-

Flexible function to generate bounding boxes

-

geo_bb_matrix()

-

Create matrix representing the spatial bounds of an object

-

mapshape()

-

Simplify geometry of spatial objects with the mapshaper library

-

mapshape_available()

-

Does the computer have mapshaper available?

-

quadrant()

-

Split a spatial object into quadrants

-

reproject()

-

Reproject lat/long spatial object so that they are in units of 1m

-

Get transport data

-

-
-

read_table_builder()

-

Import and format Australian Bureau of Statistics (ABS) TableBuilder files

-

Example data

-

-
-
+
+

Work with OD data

+ + + + +
+ + + + +
+ + od2line() +
+
Convert origin-destination data to spatial lines
+
+ + od2odf() +
+
Extract coordinates from OD data
+
+ + od_aggregate_from() +
+
Summary statistics of trips originating from zones in OD data
+
+ + od_aggregate_to() +
+
Summary statistics of trips arriving at destination zones in OD data
+
+ + od_coords() +
+
Create matrices representing origin-destination coordinates
+
+ + od_coords2line() +
+
Convert origin-destination coordinates into desire lines
+
+ + od_id_szudzik() od_id_max_min() od_id_character() +
+
Combine two ID values to create a single ID number
+
+ + od_id_order() +
+
Generate ordered ids of OD pairs so lowest is always first +This function is slow on large datasets, see szudzik_pairing for faster alternative
+
+ + od_oneway() +
+
Aggregate od pairs they become non-directional
+
+ + od_to_odmatrix() +
+
Convert origin-destination data from long to wide format
+
+ + odmatrix_to_od() +
+
Convert origin-destination data from wide to long format
+
+ + points2flow() +
+
Convert a series of points into geographical flows
+
+ + points2odf() +
+
Convert a series of points into a dataframe of origins and destinations
+
+

Work with (desire) lines

+ + + + +
+ + + + +
+ + angle_diff() +
+
Calculate the angular difference between lines and a predefined bearing
+
+ + geo_toptail() +
+
Clip the first and last n metres of SpatialLines
+
+ + is_linepoint() +
+
Identify lines that are points
+
+ + line2df() +
+
Convert geographic line objects to a data.frame with from and to coords
+
+ + line2points() line2pointsn() line2vertices() +
+
Convert a spatial (linestring) object to points
+
+ + line_bearing() +
+
Find the bearing of straight lines
+
+ + line_breakup() +
+
Break up line objects into shorter segments
+
+ + line_midpoint() +
+
Find the mid-point of lines
+
+ + line_segment() +
+
Divide sf LINESTRING objects into regular segments
+
+ + line_via() +
+
Add geometry columns representing a route via intermediary points
+
+ + mats2line() +
+
Convert 2 matrices to lines
+
+ + n_vertices() +
+
Retrieve the number of vertices in sf objects
+
+ + onewaygeo() +
+
Aggregate flows so they become non-directional (by geometry - the slow way)
+
+ + points2line() +
+
Convert a series of points, or a matrix of coordinates, into a line
+
+ + toptail_buff() +
+
Clip the beginning and ends of sf LINESTRING objects
+
+ + line_cast() +
+
Convert multilinestring object into linestrings, without losing and vertices
+
+

Work with and analyse routes

+ + + + +
+ + + + +
+ + route_average_gradient() +
+
Return average gradient across a route
+
+ + route_rolling_average() +
+
Return smoothed averages of vector
+
+ + route_rolling_diff() +
+
Return smoothed differences between vector values
+
+ + route_rolling_gradient() +
+
Calculate rolling average gradient from elevation data at segment level
+
+ + route_sequential_dist() +
+
Calculate the sequential distances between sequential coordinate pairs
+
+ + route_slope_matrix() +
+
Calculate the gradient of line segments from a matrix of coordinates
+
+ + route_slope_vector() +
+
Calculate the gradient of line segments from distance and elevation vectors
+
+ + route() +
+
Plan routes on the transport network
+
+ + route_bikecitizens() +
+
Get a route from the BikeCitizens web service
+
+ + route_dodgr() +
+
Route on local data using the dodgr package
+
+ + route_google() +
+
Find shortest path using Google services
+
+ + route_nearest_point() +
+
Find nearest route to a given point
+
+ + route_network_sf +
+
Spatial lines dataset representing a route network
+
+ + route_network_small +
+
Spatial lines dataset representing a small route network
+
+ + route_osrm() +
+
Plan routes on the transport network using the OSRM server
+
+ + route_split() +
+
Split route in two at point on or near network
+
+ + route_split_id() +
+
Split route based on the id or coordinates of one of its vertices
+
+ + routes_fast_sf +
+
Spatial lines dataset of commuter flows on the travel network
+
+ + routes_slow_sf +
+
Spatial lines dataset of commuter flows on the travel network
+
+

Routing

+ + + + +
+ + + + +
+ + route() +
+
Plan routes on the transport network
+
+ + route_dodgr() +
+
Route on local data using the dodgr package
+
+ + route_osrm() +
+
Plan routes on the transport network using the OSRM server
+
+

Work with nodes

+ + + + +
+ + + + +
+ + geo_code() +
+
Convert text strings into points on the map
+
+

Route network functions

+ + + + +
+ + + + +
+ + rnet_add_node() +
+
Add a node to route network
+
+ + rnet_boundary_points() rnet_boundary_df() rnet_boundary_unique() rnet_boundary_points_lwgeom() rnet_duplicated_vertices() +
+
Get points at the beginner and end of linestrings
+
+ + rnet_breakup_vertices() +
+
Break up an sf object with LINESTRING geometry.
+
+ + rnet_cycleway_intersection +
+
Example of cycleway intersection data showing problems for SpatialLinesNetwork objects
+
+ + rnet_get_nodes() +
+
Extract nodes from route network
+
+ + rnet_group() +
+
Assign segments in a route network to groups
+
+ + rnet_join() +
+
Spatial join function that is designed to add columns to a 'target' route network +from a 'source' route network that contains the base geometry, e.g. from OSM
+
+ + rnet_overpass +
+
Example of overpass data showing problems for SpatialLinesNetwork objects
+
+ + rnet_roundabout +
+
Example of roundabout data showing problems for SpatialLinesNetwork objects
+
+ + rnet_split_lines() +
+
Split lines in a route network based points
+
+ + rnet_subset() +
+
Subset one route network based on overlaps with another
+
+ + overline() overline2() +
+
Convert series of overlapping lines into a route network
+
+ + overline_intersection() +
+
Convert series of overlapping lines into a route network
+
+ + gsection() +
+
Function to split overlapping SpatialLines into segments
+
+ + islines() +
+
Do the intersections between two geometries create lines?
+
+

Geographic functions

+ + + + +
+ + + + +
+ + bbox_scale() +
+
Scale a bounding box
+
+ + geo_bb() +
+
Flexible function to generate bounding boxes
+
+ + geo_bb_matrix() +
+
Create matrix representing the spatial bounds of an object
+
+ + geo_buffer() +
+
Perform a buffer operation on a temporary projected CRS
+
+ + geo_length() +
+
Calculate line length of line with geographic or projected CRS
+
+ + geo_projected() +
+
Perform GIS functions on a temporary, projected version of a spatial object
+
+ + geo_select_aeq() +
+
Select a custom projected CRS for the area of interest
+
+ + quadrant() +
+
Split a spatial object into quadrants
+
+ + stplanr-deprecated +
+
Deprecated functions in stplanr
+
+ + stplanr-package stplanr +
+
stplanr: Sustainable Transport Planning with R
+
+

Get transport data

+ + + + +
+ + + + +
+ + cents_sf +
+
Spatial points representing home locations
+
+ + destinations_sf +
+
Example destinations data
+
+ + flow +
+
Data frame of commuter flows
+
+ + flow_dests +
+
Data frame of invented +commuter flows with destinations in a different layer than the origins
+
+ + flowlines_sf +
+
Spatial lines dataset of commuter flows
+
+ + od_data_lines +
+
Example of desire line representations of origin-destination data from UK Census
+
+ + od_data_routes +
+
Example segment-level route data
+
+ + od_data_sample +
+
Example of origin-destination data from UK Census
+
+ + osm_net_example +
+
Example of OpenStreetMap road network
+
+ + read_table_builder() +
+
Import and format Australian Bureau of Statistics (ABS) TableBuilder files
+
+ + route_network_sf +
+
Spatial lines dataset representing a route network
+
+ + route_network_small +
+
Spatial lines dataset representing a small route network
+
+ + routes_fast_sf +
+
Spatial lines dataset of commuter flows on the travel network
+
+ + routes_slow_sf +
+
Spatial lines dataset of commuter flows on the travel network
+
+ + zones_sf +
+
Spatial polygons of home locations for flow analysis.
+
+

Example data

+ + + + +
+ + + - -
+ +
+
-
+ - - + + diff --git a/docs/reference/is_linepoint.html b/docs/reference/is_linepoint.html index 67802e7c..a3ba31cc 100644 --- a/docs/reference/is_linepoint.html +++ b/docs/reference/is_linepoint.html @@ -1,266 +1,168 @@ - - - - - - - -Identify lines that are points — is_linepoint • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Identify lines that are points

- Source: R/linefuns.R - +
+

Identify lines that are points

+ Source: R/linefuns.R +
is_linepoint.Rd
-
+

OD matrices often contain 'intrazonal' flows, where the origin is the same point as the destination. This function can help identify such intrazonal OD pairs, using 2 criteria: the total number of vertices (2 or fewer) and whether the origin and destination are the same.

- 
is_linepoint(l)
- -

Arguments

- - - - - - -
l

A spatial lines object

+
+

Usage

+ 
is_linepoint(l)
+
-

Details

+
+

Arguments

+
l
+

A spatial lines object

+
+
+

Details

Returns a boolean vector. TRUE means that the associated line is in fact a point (has no distance). This can be useful for removing data that will not be plotted.

-

See also

- -

Other lines: -angle_diff(), -geo_toptail(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
data(flowlines)
-islp <- is_linepoint(flowlines)
-nrow(flowlines)
-
#> [1] 49
sum(islp)
-
#> [1] 7
# Remove invisible 'linepoints'
-nrow(flowlines[!islp, ])
-
#> [1] 42
-
- -
+
+

Examples

+ 
islp <- is_linepoint(flowlines_sf)
+nrow(flowlines_sf)
+#> [1] 49
+sum(islp)
+#> [1] 7
+# Remove invisible 'linepoints'
+nrow(flowlines_sf[!islp, ])
+#> [1] 42
+
+
+
-
+ - - + + diff --git a/docs/reference/islines.html b/docs/reference/islines.html index 24620ee1..4d965d2c 100644 --- a/docs/reference/islines.html +++ b/docs/reference/islines.html @@ -1,268 +1,154 @@ - - - - - - - -Do the intersections between two geometries create lines? — islines • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Do the intersections between two geometries create lines?

- Source: R/overline.R - +
+

Do the intersections between two geometries create lines?

+ Source: R/overline.R +
islines.Rd
-
-

This is a function required in overline(). It identifies +

+

This is a function required in overline(). It identifies whether sets of lines overlap (beyond shared points) or not.

- 
islines(g1, g2)
+
+

Usage

+ 
islines(g1, g2)
+
-

Arguments

- - - - - - - - - - -
g1

A spatial object

g2

A spatial object

+
+

Arguments

+
g1
+

A spatial object

-

See also

-

Other rnet: -SpatialLinesNetwork, -calc_catchment_sum(), -calc_catchment(), -calc_moving_catchment(), -calc_network_catchment(), -find_network_nodes(), -gsection(), -lineLabels(), -overline_spatial(), -overline(), -plot,SpatialLinesNetwork,ANY-method, -plot,sfNetwork,ANY-method, -rnet_breakup_vertices(), -rnet_group(), -sln2points(), -sum_network_links(), -sum_network_routes()

+
g2
+

A spatial object

-

Examples

- 
if (FALSE) {
-rnet <- overline(routes_fast[c(2, 3, 22), ], attrib = "length")
-plot(rnet)
-lines(routes_fast[22, ], col = "red") # line without overlaps
-islines(routes_fast[2, ], routes_fast[3, ])
-islines(routes_fast[2, ], routes_fast[22, ])
-# sf implementation
-islines(routes_fast_sf[2, ], routes_fast_sf[3, ])
-islines(routes_fast_sf[2, ], routes_fast_sf[22, ])
-}
-
-
- -
+
+
+

See also

+

Other rnet: +gsection(), +overline(), +rnet_breakup_vertices(), +rnet_group()

+
+ +
+

Examples

+ 
if (FALSE) {
+# sf implementation
+islines(routes_fast_sf[2, ], routes_fast_sf[3, ])
+islines(routes_fast_sf[2, ], routes_fast_sf[22, ])
+}
+
+
+
-
+ - - + + diff --git a/docs/reference/line2df.html b/docs/reference/line2df.html index b87da7f8..f9ae64b9 100644 --- a/docs/reference/line2df.html +++ b/docs/reference/line2df.html @@ -1,283 +1,158 @@ - - - - - - - -Convert geographic line objects to a data.frame with from and to coords — line2df • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert geographic line objects to a data.frame with from and to coords

- Source: R/od-funs.R - +
+

Convert geographic line objects to a data.frame with from and to coords

+ Source: R/od-funs.R +
line2df.Rd
-
+

This function returns a data frame with fx and fy and tx and ty variables representing the beginning and end points of spatial line features respectively.

- 
line2df(l)
- -

Arguments

- - - - - - -
l

A spatial lines object

- -

See also

+
+

Usage

+ 
line2df(l)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
l
+

A spatial lines object

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
data(flowlines)
-line2df(flowlines[5, ]) # beginning and end of a single straight line
-
#> # A tibble: 1 x 5
-#>   object    fx    fy    tx    ty
-#>    <dbl> <dbl> <dbl> <dbl> <dbl>
-#> 1      1 -1.52  53.8 -1.52  53.8
line2df(flowlines) # on multiple lines
-
#> # A tibble: 49 x 5
-#>    object    fx    fy    tx    ty
-#>     <dbl> <dbl> <dbl> <dbl> <dbl>
-#>  1      1 -1.52  53.8 -1.52  53.8
-#>  2      2 -1.52  53.8 -1.54  53.8
-#>  3      3 -1.52  53.8 -1.55  53.8
-#>  4      4 -1.52  53.8 -1.53  53.8
-#>  5      5 -1.52  53.8 -1.52  53.8
-#>  6      6 -1.52  53.8 -1.51  53.8
-#>  7      7 -1.52  53.8 -1.52  53.8
-#>  8      8 -1.54  53.8 -1.52  53.8
-#>  9      9 -1.54  53.8 -1.54  53.8
-#> 10     10 -1.54  53.8 -1.55  53.8
-#> # … with 39 more rows
line2df(routes_fast[5:6, ]) # beginning and end of routes
-
#> # A tibble: 2 x 5
-#>   object    fx    fy    tx    ty
-#>    <dbl> <dbl> <dbl> <dbl> <dbl>
-#> 1      1 -1.52  53.8 -1.52  53.8
-#> 2      2 -1.52  53.8 -1.51  53.8
line2df(routes_fast_sf[5:6, ]) # beginning and end of routes
-
#> # A tibble: 2 x 5
-#>      L1    fx    fy    tx    ty
-#>   <dbl> <dbl> <dbl> <dbl> <dbl>
-#> 1     1 -1.52  53.8 -1.52  53.8
-#> 2     2 -1.52  53.8 -1.51  53.8
-
- -
+
+

Examples

+ 
line2df(routes_fast_sf[5:6, ]) # beginning and end of routes
+#> # A tibble: 2 × 5
+#>      L1    fx    fy    tx    ty
+#>   <dbl> <dbl> <dbl> <dbl> <dbl>
+#> 1     1 -1.52  53.8 -1.52  53.8
+#> 2     2 -1.52  53.8 -1.51  53.8
+
+
+
-
+ - - + + diff --git a/docs/reference/line2points-2.png b/docs/reference/line2points-2.png index ed7412d65f3a0b378ec9159bec017f444c4a6882..8c8b84cdc5891401ed15a090bdb26164ce4a23d3 100644 GIT binary patch literal 25427 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%0DX(c*{J!!|gg9 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 literal 26845 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 ah2gE-Sv?$7{@3A2022dqXw? - - - - - - -Convert a spatial (linestring) object to points — line2points • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert a spatial (linestring) object to points

- Source: R/od-funs.R - +
+

Convert a spatial (linestring) object to points

+ Source: R/od-funs.R +
line2points.Rd
-
+

The number of points will be double the number of lines with line2points. A closely related function, line2pointsn returns all the points that were line vertices. The points corresponding with a given line, i, will be @@ -160,125 +77,113 @@

Convert a spatial (linestring) object to points

1 LINESTRING with 2 POINTS, then it returns an empty sf object.

- 
line2points(l, ids = rep(1:nrow(l)))
-
-line2pointsn(l)
-
-line2vertices(l)
- -

Arguments

- - - - - - - - - - -
l

An sf object or a SpatialLinesDataFrame from the older sp package

ids

Vector of ids (by default 1:nrow(l))

- -

See also

+
+

Usage

+ 
line2points(l, ids = rep(1:nrow(l)))
+
+line2pointsn(l)
+
+line2vertices(l)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
l
+

An sf object or a SpatialLinesDataFrame from the older sp package

+ + +
ids
+

Vector of ids (by default 1:nrow(l))

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
l <- routes_fast_sf[2, ]
-lpoints <- line2points(l)
-plot(l$geometry)
-
plot(lpoints, add = TRUE)
-
# test all vertices:
-plot(l$geometry)
-
lpoints2 <- line2pointsn(l)
-plot(lpoints2$geometry, add = TRUE)
-

-# extract only internal vertices
-l_internal_vertices <- line2vertices(l)
-plot(sf::st_geometry(l), reset = FALSE)
-
plot(l_internal_vertices, add = TRUE)
-
# The boundary points are missing
-
-
- -
+
+

Examples

+ 
l <- routes_fast_sf[2, ]
+lpoints <- line2points(l)
+plot(l$geometry)
+plot(lpoints, add = TRUE)
+
+# test all vertices:
+plot(l$geometry)
+lpoints2 <- line2pointsn(l)
+plot(lpoints2$geometry, add = TRUE)
+
+
+# extract only internal vertices
+l_internal_vertices <- line2vertices(l)
+plot(sf::st_geometry(l), reset = FALSE)
+plot(l_internal_vertices, add = TRUE)
+
+# The boundary points are missing
+
+
+
-
+ - - + + diff --git a/docs/reference/line_bearing.html b/docs/reference/line_bearing.html index d948b8db..5e556f65 100644 --- a/docs/reference/line_bearing.html +++ b/docs/reference/line_bearing.html @@ -1,276 +1,175 @@ - - - - - - - -Find the bearing of straight lines — line_bearing • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Find the bearing of straight lines

- Source: R/linefuns.R - +
+

Find the bearing of straight lines

+ Source: R/linefuns.R +
line_bearing.Rd
-
-

This is a simple wrapper around the geosphere function bearing() to return the +

+

This function returns the bearing (in degrees relative to north) of lines.

- 
line_bearing(l, bidirectional = FALSE)
+
+

Usage

+ 
line_bearing(l, bidirectional = FALSE)
+
+ +
+

Arguments

+
l
+

A spatial lines object

-

Arguments

- - - - - - - - - - -
l

A spatial lines object

bidirectional

Should the result be returned in a bidirectional format? -Default is FALSE. If TRUE, the same line in the oposite direction would have the same bearing

-

Details

+
bidirectional
+

Should the result be returned in a bidirectional format? +Default is FALSE. If TRUE, the same line in the oposite direction would have the same bearing

+
+
+

Details

Returns a boolean vector. TRUE means that the associated line is in fact a point (has no distance). This can be useful for removing data that will not be plotted.

-

See also

- -

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
lib_versions <- sf::sf_extSoftVersion()
-lib_versions
-
#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
-#>        "3.8.0"        "3.0.4"        "7.0.0"         "true"         "true" 
# fails on some systems (with early versions of PROJ)
-if(lib_versions[3] >= "6.3.1") {
-  bearings_sf_1_9 <- line_bearing(flowlines_sf[1:5, ])
-  bearings_sf_1_9 # lines of 0 length have NaN bearing
-  bearings_sp_1_9 <- line_bearing(flowlines[1:5, ])
-  bearings_sp_1_9
-  plot(bearings_sf_1_9, bearings_sp_1_9)
-  line_bearing(flowlines_sf[1:5, ], bidirectional = TRUE)
-  line_bearing(flowlines[1:5, ], bidirectional = TRUE)
-}
-
#> [1]  0.000000 87.950582 77.554344 36.163396  6.668455
-
- -
+
+

Examples

+ 
lib_versions <- sf::sf_extSoftVersion()
+lib_versions
+#>           GEOS           GDAL         proj.4 GDAL_with_GEOS     USE_PROJ_H 
+#>       "3.10.2"        "3.4.1"        "8.2.1"         "true"         "true" 
+#>           PROJ 
+#>        "8.2.1" 
+# fails on some systems (with early versions of PROJ)
+if (lib_versions[3] >= "6.3.1") {
+  bearings_sf_1_9 <- line_bearing(flowlines_sf[1:5, ])
+  bearings_sf_1_9 # lines of 0 length have NaN bearing
+  line_bearing(flowlines_sf[1:5, ], bidirectional = TRUE)
+}
+#> [1]       NaN 87.950582 77.554344 36.163396  6.668455
+
+
+
-
+ - - + + diff --git a/docs/reference/line_midpoint.html b/docs/reference/line_midpoint.html index 1f4be1f0..59516f4d 100644 --- a/docs/reference/line_midpoint.html +++ b/docs/reference/line_midpoint.html @@ -1,263 +1,161 @@ - - - - - - - -Find the mid-point of lines — line_midpoint • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Find the mid-point of lines

- Source: R/linefuns.R - +
+

Find the mid-point of lines

+ Source: R/linefuns.R +
line_midpoint.Rd
-
-

This is a wrapper around SpatialLinesMidPoints() that allows it to find the midpoint -of lines that are not projected, which have a lat/long CRS.

+
+

Find the mid-point of lines

- 
line_midpoint(l)
- -

Arguments

- - - - - - -
l

A spatial lines object

- -

See also

+
+

Usage

+ 
line_midpoint(l, tolerance = NULL)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
l
+

A spatial lines object

+ + +
tolerance
+

The tolerance used to break lines at verteces. +See lwgeom::st_linesubstring().

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
data(routes_fast)
-line_midpoint(routes_fast[2:5, ])
-
#> Transforming to CRS +proj=aeqd +lat_0=53.82475517 +lon_0=-1.52535729 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs
#> Warning: CRS object has comment, which is lost in output
#> class       : SpatialPointsDataFrame 
-#> features    : 4 
-#> extent      : -1.533454, -1.514055, 53.82031, 53.82947  (xmin, xmax, ymin, ymax)
-#> crs         : +proj=longlat +datum=WGS84 +no_defs 
-#> variables   : 17
-#> names       : plan, start, finish, length, time, waypoint, cum_hill, change_elev, dif_max_min, up_tot, down_tot,         av_incline, co2_saving, calories, busyness, ... 
-#> min values  :    1,     1,      1,   1535,  313,       37,       87,         -61,          39,     14,       47, 0.0376344086021505,        286,       20,     2259, ... 
-#> max values  :    1,     1,      1,   2976,  829,       97,      112,          -4,          65,     54,       75, 0.0566775244299674,        555,       78,     7062, ...
-
- -
+
+

Examples

+ 
l = routes_fast_sf[2:5, ]
+plot(l$geometry, col = 2:5)
+midpoints = line_midpoint(l)
+#> Warning: st_linesubstring does not follow a geodesic; you may want to use st_geod_segmentize first
+#> Warning: st_linesubstring does not follow a geodesic; you may want to use st_geod_segmentize first
+plot(midpoints, add = TRUE)
+
+
+
+
-
+ - - + + diff --git a/docs/reference/line_segment-1.png b/docs/reference/line_segment-1.png index 830ade4754d7c3a5d5a2ee7ae9a76d885abf8025..dd3330a1504c4cec508307948f051d5399406c8f 100644 GIT binary patch literal 17909 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 literal 20837 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 diff --git a/docs/reference/line_segment.html b/docs/reference/line_segment.html index 21da2143..49fea7b5 100644 --- a/docs/reference/line_segment.html +++ b/docs/reference/line_segment.html @@ -1,265 +1,165 @@ - - - - - - - -Divide SpatialLines dataset into regular segments — line_segment • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Divide SpatialLines dataset into regular segments

- Source: R/linefuns.R - +
+

Divide sf LINESTRING objects into regular segments

+ Source: R/linefuns.R +
line_segment.Rd
-
-

Divide SpatialLines dataset into regular segments

+
+

Divide sf LINESTRING objects into regular segments

- 
line_segment(l, n_segments, segment_length = NA)
- -

Arguments

- - - - - - - - - - - - - - -
l

A spatial lines object

n_segments

The number of segments to divide the line into

segment_length

The approximate length of segments in the output (overides n_segments if set)

- -

See also

+
+

Usage

+ 
line_segment(l, n_segments, segment_length = NA)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
l
+

A spatial lines object

+ + +
n_segments
+

The number of segments to divide the line into

+ + +
segment_length
+

The approximate length of segments in the output (overides n_segments if set)

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
data(routes_fast)
-l <- routes_fast[2, ]
-library(sp)
-l_seg2 <- line_segment(l = l, n_segments = 2)
-
#> Transforming to CRS +proj=aeqd +lat_0=53.82911343 +lon_0=-1.52653966 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs
#> Warning: CRS object has comment, which is lost in output
plot(l_seg2, col = l_seg2$group, lwd = 50)
-
-
- -
+
+

Examples

+ 
l <- routes_fast_sf[2, ]
+l_seg2 <- line_segment(l = l, n_segments = 2)
+#> Warning: st_linesubstring does not follow a geodesic; you may want to use st_geod_segmentize first
+#> Warning: st_linesubstring does not follow a geodesic; you may want to use st_geod_segmentize first
+#> Warning: st_linesubstring does not follow a geodesic; you may want to use st_geod_segmentize first
+#> Warning: st_linesubstring does not follow a geodesic; you may want to use st_geod_segmentize first
+plot(sf::st_geometry(l_seg2), col = 1:2, lwd = 5)
+
+
+
+
-
+ - - + + diff --git a/docs/reference/line_via.html b/docs/reference/line_via.html index 3224ee56..025208f5 100644 --- a/docs/reference/line_via.html +++ b/docs/reference/line_via.html @@ -1,278 +1,210 @@ - - - - - - - -Add geometry columns representing a route via intermediary points — line_via • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +Add geometry columns representing a route via intermediary points — line_via • stplanr + Skip to contents + - - - - - +
-
-
-

Add geometry columns representing a route via intermediary points

- Source: R/line_via.R - +
+

Add geometry columns representing a route via intermediary points

+ Source: R/line_via.R +
line_via.Rd
-
+

Takes an origin (A) and destination (B), represented by the linestring l, and generates 3 extra geometries based on points p:

- 
line_via(l, p)
+
+

Usage

+ 
line_via(l, p)
+
+ +
+

Arguments

+
l
+

A spatial lines object

-

Arguments

- - - - - - - - - - -
l

A spatial lines object

p

A spatial points object

-

Details

+
p
+

A spatial points object

+
+
+

Details

-
    -

  1. From A to P1 (P1 being the nearest point to A)

    2. +

    1. From A to P1 (P1 being the nearest point to A)

    2. From P1 to P2 (P2 being the nearest point to B)

    3. From P2 to B

      4. -
    - -

    See also

    - -

    Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

    +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
l <- flowlines_sf[2:4, ]
-p <- destinations_sf
-lv <- line_via(l, p)
-# library(mapview)
-# mapview(lv) +
-#    mapview(lv$leg_orig, col = "red")
-library(sf)
-plot(lv[3], lwd = 9, reset = FALSE)
-
plot(lv$leg_orig, col = "red", lwd = 5, add = TRUE)
-
plot(lv$leg_via, col = "black", add = TRUE)
-
plot(lv$leg_dest, col = "green", lwd = 5, add = TRUE)
-
-
- -
+
+

Examples

+ 
library(sf)
+l <- flowlines_sf[2:4, ]
+p <- destinations_sf
+lv <- line_via(l, p)
+lv
+#> Simple feature collection with 3 features and 15 fields
+#> Active geometry column: geometry
+#> Geometry type: LINESTRING
+#> Dimension:     XY
+#> Bounding box:  xmin: -1.550807 ymin: 53.81756 xmax: -1.516734 ymax: 53.82887
+#> Geodetic CRS:  WGS 84
+#>        Area.of.residence Area.of.workplace All Work.mainly.at.or.from.home
+#> 920575         E02002361         E02002363  38                           0
+#> 920578         E02002361         E02002367  10                           0
+#> 920582         E02002361         E02002371  44                           0
+#>        Underground..metro..light.rail..tram Train Bus..minibus.or.coach Taxi
+#> 920575                                    0     1                     4    1
+#> 920578                                    0     0                     1    0
+#> 920582                                    0     0                     2    2
+#>        Motorcycle..scooter.or.moped Driving.a.car.or.van
+#> 920575                            0                   24
+#> 920578                            0                    8
+#> 920582                            0                   28
+#>        Passenger.in.a.car.or.van Bicycle On.foot Other.method.of.travel.to.work
+#> 920575                         4       0       4                              0
+#> 920578                         0       0       1                              0
+#> 920582                         3       3       6                              0
+#>                         id                       geometry
+#> 920575 E02002361 E02002363 LINESTRING (-1.516734 53.82...
+#> 920578 E02002361 E02002367 LINESTRING (-1.516734 53.82...
+#> 920582 E02002361 E02002371 LINESTRING (-1.516734 53.82...
+#>                              leg_orig                        leg_via
+#> 920575 LINESTRING (-1.516734 53.82... LINESTRING (-1.517333 53.82...
+#> 920578 LINESTRING (-1.516734 53.82... LINESTRING (-1.517333 53.82...
+#> 920582 LINESTRING (-1.516734 53.82... LINESTRING (-1.517333 53.82...
+#>                              leg_dest
+#> 920575 LINESTRING (-1.53741 53.829...
+#> 920578 LINESTRING (-1.555112 53.82...
+#> 920582 LINESTRING (-1.534205 53.81...
+# library(mapview)
+# mapview(lv) +
+#    mapview(lv$leg_orig, col = "red")
+plot(lv[3], lwd = 9, reset = FALSE)
+plot(lv$leg_orig, col = "red", lwd = 5, add = TRUE)
+plot(lv$leg_via, col = "black", add = TRUE)
+plot(lv$leg_dest, col = "green", lwd = 5, add = TRUE)
+
+
+
+
-
+ - - + + diff --git a/docs/reference/mats2line.html b/docs/reference/mats2line.html index 907cca5f..b18f6442 100644 --- a/docs/reference/mats2line.html +++ b/docs/reference/mats2line.html @@ -1,264 +1,176 @@ - - - - - - - -Convert 2 matrices to lines — mats2line • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert 2 matrices to lines

- Source: R/line_via.R - +
+

Convert 2 matrices to lines

+ Source: R/line_via.R +
mats2line.Rd
-
+

Convert 2 matrices to lines

- 
mats2line(mat1, mat2)
- -

Arguments

- - - - - - - - - - -
mat1

Matrix representing origins

mat2

Matrix representing destinations

- -

See also

+
+

Usage

+ 
mats2line(mat1, mat2, crs = NA)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
mat1
+

Matrix representing origins

+ + +
mat2
+

Matrix representing destinations

+ + +
crs
+

Number representing the coordinate system of the data, e.g. 4326

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +n_vertices(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
m1 <- matrix(c(1, 2, 1, 2), ncol = 2)
-m2 <- matrix(c(9, 9, 9, 1), ncol = 2)
-l <- mats2line(m1, m2)
-class(l)
-
#> [1] "sfc_LINESTRING" "sfc"           
lsf <- sf::st_sf(l, crs = 4326)
-class(lsf)
-
#> [1] "sf"         "data.frame"
plot(lsf)
-
# mapview::mapview(lsf)
-
-
- -
+
+

Examples

+ 
m1 <- matrix(c(1, 2, 1, 2), ncol = 2)
+m2 <- matrix(c(9, 9, 9, 1), ncol = 2)
+l <- mats2line(m1, m2)
+class(l)
+#> [1] "sfc_LINESTRING" "sfc"           
+l
+#> Geometry set for 2 features 
+#> Geometry type: LINESTRING
+#> Dimension:     XY
+#> Bounding box:  xmin: 1 ymin: 1 xmax: 9 ymax: 9
+#> CRS:           NA
+#> LINESTRING (1 1, 9 9)
+#> LINESTRING (2 2, 9 1)
+lsf <- sf::st_sf(l, crs = 4326)
+class(lsf)
+#> [1] "sf"         "data.frame"
+plot(lsf)
+
+# mapview::mapview(lsf)
+
+
+
-
+ - - + + diff --git a/docs/reference/n_vertices.html b/docs/reference/n_vertices.html index f8535ffd..4290b30d 100644 --- a/docs/reference/n_vertices.html +++ b/docs/reference/n_vertices.html @@ -1,263 +1,156 @@ - - - - - - - -Retrieve the number of vertices from a SpatialLines or SpatialPolygons object — n_vertices • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Retrieve the number of vertices from a SpatialLines or SpatialPolygons object

- Source: R/linefuns.R - +
+

Retrieve the number of vertices in sf objects

+ Source: R/linefuns.R +
n_vertices.Rd
-
-

Returns a vector of the same length as the number of lines, -with the number of vertices per line or polygon.

+
+

Returns a vector of the same length as the number of sf objects.

- 
n_vertices(l)
- -

Arguments

- - - - - - -
l

A SpatialLines or SpatalPolygons object

- -

Details

- -

See https://gis.stackexchange.com/questions/58147/ for more information.

-

See also

+
+

Usage

+ 
n_vertices(l)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -onewaygeo(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
l
+

An sf object with LINESTRING geometry

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +onewaygeo(), +points2line(), +toptail_buff()

+
-

Examples

- 
n_vertices(routes_fast)
-
#>  [1]   2  53  97  37  41  73 104  53   2  44  59  79  97 121  98  65   2  64  84
-#> [20] 114 131  44  59  55   2  22  52  64  46  79  75  22   2  27  65  70  87 105
-#> [39]  52  27   2  46 114 126 130  69  65  46   2
n_vertices(routes_fast_sf)
-
#>  [1]   2  53  97  37  41  73 104  53   2  44  59  79  97 121  98  65   2  64  84
-#> [20] 114 131  44  59  55   2  22  52  64  46  79  75  22   2  27  65  70  87 105
-#> [39]  52  27   2  46 114 126 130  69  65  46   2
-
- -
+
+

Examples

+ 
l = routes_fast_sf
+n_vertices(l)
+#>  [1]   2  53  97  37  41  73 104  53   2  44  59  79  97 121  98  65   2  64  84
+#> [20] 114 131  44  59  55   2  22  52  64  46  79  75  22   2  27  65  70  87 105
+#> [39]  52  27   2  46 114 126 130  69  65  46   2
+n_vertices(zones_sf)
+#> [1] 6 8 8 9 7 6 8 7
+
+
+
-
+ - - + + diff --git a/docs/reference/od2line-1.png b/docs/reference/od2line-1.png index ce47f4d0d9c4e21db7bf33045c3c4fa62802e656..294592f5e9931c7ac6549ea7d0d2d6677b707531 100644 GIT binary patch literal 57018 zcmeFXXH=72*EJeIMMXfRDF}#Cq$^#jiin{~FQG~A9YPO+fP%Epq)YF;*HENa>5$NC zD4{3xoZx*w=Y7xl{(e87jFDVpBxB^7*V=2(HP>AG`zHly;=9y$0RR9o@Z)=B0N|z@ z06<`P`xfpScx>7p?sCgeR{A~eihG?(Hb8KfJN6&7oB#mYpzAkY`0Bn10Pqw5eE(L} zEopn!Jz7^S9*Z4v8mz0yR(<%v!N8pSfw@1=3);>XyrH+9Wf<-O)jnF2Gv@hg|y?M0b1dlSeS93}8|!Qs?O@UP|HtEqnKTiel8p zrq5A_hLY2>dq!|Bb+ZBk+GK0#iByQ#b$q*{y-M(7{OOpP92v zMbIM%)aQl8>C=gSeggp9$UK4d@=#a@tbvL4rRGiie*p-%e9K%Pr(JTDN#I0!0qNuT zv`3Di>LoP#oXD?l^ZrBIrC(;5#0pS*uJM^o^Tu<Y6z5w zISM)^?Bt5)ZR8kC-cWKg=zK+0q-nRo53KoEuR5XyrK8R@!~?XfF)ZL7tOcDbqZ~2z zYAOH#zX|SBQ>U{m%kwA^yQ(oAgzQRGa;lONakjHdR{@R%Tw^uh{aN2YYQ^L&H?rq4sUPVaUXP*B6&A|E1DUlQAnVF2 z^V2i<^FMJF72eCAsj4tKDdnJ1kB<#pRima0C={krr8U!XdH7CEf%;+4CyGAyholr` zo>JuR+_%#>9Jpl>PGvz}TwfVuS%9}4xV{RJXhoA2>vTtBe(7|RH?UV|7A!5^4JOaa zEulO6?9$;d@WZH!L%U>*Z2Z#6wIox?|DXdGZ@XX;Jseo;tvLpZw0i&9Nte8HK&}{L zG7L3O$`~3|>H3T4ci3lVC#S|Py8MlAY7aWHddv9=5EWDWh2@%0^eBXb)X4co@8%B% zEDgWMLACyJJ_TmWt0jH$yqCe$Oqn0N^A9`bA)opQ&3cN%XGZ3ROHm7 zP0xMKyVZ~TblLi7WCc0uS(n(;_H^vt^Cs1N60RWL=r z@mmNy_XoK6{6q!@yNz3&kOzCX$2S0>ZGjls8R=QiFFv{>&wxWkG!kz{9s#46lAj|l zpJe#fsr3=pCc9d!S;6bG?5g$1~L zu>$YSL{0inD3j-zM~(;`jHQ1HPUldIHc?V#lTu>kWzSL?8#mdX;V?^%PaiB4aog$c zpHX2dvRJXvBCnw|DasPkqgis3Z|JgW=#3gLVd_bUEidQSwLs{_n$Tt~Ce!W;Uvv!m zQFw4!Ki5FGulv;9AB=^gpq0-Ck%A#G&u)FX24o$FykbP=9a%e{996U&=CS2$`p0ma z%CYZT;#amr`tJaMmw>5sJY2fK^EGD|QPPZJPmyFJ%*g>Io+X(gjI=M1EL&@5iTxcD zjx}YNLC%7Y2NZNUF@W>IrLOdZ1nc{Hp~U2|9ISRbmJ%I2 zv<#S!!Ny8xL(hjkdqq)09-n6`KSTARRT(UdTZv%ai_HY6*rR&=o@-A(rJn3#^%K1YT=7UhRQ5wh<-IyM)#A9wa;B$@RF{qmZaU8Fv~Uu$YQ zt6NN&_Xupq8PPPiNG+wsCd(TlV?iFHT%jyYUeuHBWftLL66umj>0)fU^L9d=&q_8U zmosEJcFfwQ2U=x8USgx@Xf^SBKS856U&F-I#$t_@Lh_xo#>m90OeMYWS!O0)eQPMn=+N+Do{8P{%a)v`>7jS091N)~^m>D<<25b&vK@umESw zRqgp%P=VUVdU;%+ik=~E0t^!0x8Mlg*Jj*o()%KPBA`LEWat z$>sa`QTGFx8B|wi3k>r{-sSePs{U?ef99^Wl*U1lCh9Q6#IRyWTK8KF=r!A_HQy|{ ziLyO*p)H;zG_&F8u5SQk)QZ?wX=;%NK&2S?`($t_sH7^B#aC6UDd)&(6I?HPFgUg} z*kAZOG#x!wDE7j#@0pc+MsAh){*1w&nRF>DktK5*5ERtJBjKe6imx%H6Aspz`BQDC zcAoAp9cTPO`dB@|8R8^WS${=uzTm>U`BqGGEKZt;ZH*SK|0NC>f0xu~yX6gp~33pi_< zO%|)AIcd5N4+~{VI=vkSQU`W2&_KKM4M}6l%+y}HOKt0YW{6%#^g-|UKErqoN^+q{ z^rDP$QT%SEbZ~;A1&W|7D0@keYgVH_E%Zs%n@J{I7Laz zjAQ_Y%LuDNo9h+?37?D|1hJ&N5P7Lk)S$Tdd&1MjV4rlcOc(9;+Hq+0U3XT8vWs3T z+jCqkPthcrL!V%VFOev$3lvU0VQWVW5Q}Kc=mV?dIRJXNo z>)5|yqx?#94YD5o zHT)ok-65Q9q+fmgpa2w=yOkF=NjE&B)w_cs-L03=jNobU&|lw5N1^iE^DzmJrT;#%NZbo~Hb%OLnuI z@nR`Hc4>!TUrf*e*`_V%-J7YuEp9m0(~jQId4|*k9xTwwWUVpmA};49sPr$JGd0c{ z=y1vJ>HN3mC-Qoo>|LULc7sw+ryd)PdZQ)WqOxy9ZM78V9FZE4Y$pP@UI)?wpmUoH(Vxa~wVM2?|0VTPfvgAMy9s$}IRuAkCqoMPiHNv zwZRtt^BT`hklzNoqDWmt^FM#yp_!a@3C=8FO3p$t?ub7?89uFpM|!;Ic(j)*KadpA0Lb|MkIR})TKu?fv0 z3M5re#z~*Pe-zNLuIH%TT;y8%kk$)5Hj7ER?27^U$xyxH_8fGtp6#6R*wG*N3<)$U zgz9n$HlbTrC$V*tOLs&xGrwt5t`3_)-h*mv&$ur(8&j!}>S{UA+gfaAbSfmFHgdbC zIN1T=4*m#br!HFr315Q!m1qEf4O;wb&3P{&a2ob{D&5VIS=Ssg55^FeG*&*l?4Wgu z!d~tS?Q&4UVM-F-@5HUt;xfxavpoHt`UQ?SaTera`NSd?-RZmKzhyULMkyw|H;xDJoqP6I z_WL@5trD=qcc6-qTStQNXeTE-^OL0T^i9UjH)*-0h39?B&;<8+oF{mfjy=oJ=FKg=_ zE?dD=Ro9W)e04P1phwR;`t5jKTgSt?h3EzV(A3Fbg^S3e`=dGBLshH%GXq;pv=i;o zs^z=Ajb&F$&*}Ac&t5^Bxh)idXW?WLm222!*QwG_dc=&{-JwEjn+yB)9gX8YvX-!( z*<#I$DAM&1*92*$EJm%{JIRr#dejeI9~NHv?T0lJ8*6KBaZNH3an6m1u0f$IKliP0 zMa}v>2$O^=bY(Na0dY#fb2!A&w7Ow9cD%7|w5fe7!xpDpOg66L^#)dtik-j5Y0`6| zj$voqnQf1z?8#>Ty0vK)?$sQ$Zvqv6iX?(^U8T-T)J$SUY(~A@K5B6ZA0@YwvU+Er z#t>>1sLfH9FSMOsJrjb6ck?eY**#$7nIfo9r5mIL>@&^$%b5xM{<`}5)Xf@asn9S% zi`Jv%&i*(qHzR9Y=k&Vj{A~#YH9}MpG;NA@TZ$o+J=^i6BF62hM|j-0FrG;*Zxf=` z$#wN)y!}=rJ%1iF_7@LyAp85cg)DdA95pf{FkBc}^g%B6W(l*Pl-~_DqCH|~MO~k* zCk3~zl+mYJ*h#7(0(glZRl1tQ)xx5QQb!(Fj4ZVN9q5(*8M2DS+wlsGNIrLE<^Z|< z@PhzHQV-o>&dckY$>Y0%r!?n!iO9T3>^ZzEOv|NbB;Hf`HT#L-0oUVK^o+WhWMX8L;k0i}zDpFRWm)CWIZY^3%)Xhu9B5$Uqkx-LuWWOnCWbL;&8tMh@(uQd8-und zCMYa;1OZ%|Xi_Y6m-R&KFViTz#_T6oi(qWLOnWXM_Z%*M$yvRNqZK~b+=j(KUQRYbIw?0E&9b<-IW z5x54;u>K(!<05F+#Or45@q7MIyIr;3NwDwh>L|OU=Y=kC^{&rEKUr6!MXiWyPtu|` z6-ox$Cor8c*-xj~cwhj8?Zo-v0p6tkW1zqjgdwNW%L^)g&S5%#I+wXFwNb?9s$%CE z3Am2xO|auE=O_gIsW0s+w9Io_%}KvkKE8>=Dpy1&m;`OHtX~G?O??zGvzPrrP_XNq zxabLz>AW_6m66qQU?TIh7<<~;vwjtcLKKZDjWZ$*dUCGWt6|>KQd|Qaes>EJf7ubb z?sY!(s(?$Y-oQ;i?hcL%=>AfI#~1?fq{JMKmE$eZ*fa9@IE#?0@mvd4v6SFhAmn2j z-!G|{sFYGZ?ljVRlFVVz%qUglsh_G=QY&zn+egFPXsBY^C_G$+>KDgW1nj=ped3|; z>4*+^@S-+&anTwxSfWUyHTr7mc;`0m-g`QAiqS_4`LhT5UJa)x>atcnZ(9heX6c$f zpZ~2ox3U%W^`>Jdr63lQ#=H{0f>>!$0xUAtGb==-*im1q+A#SfB^jD6ABIz{#IQ3~ zZK^%(wEGtckV|FtITsg7)`PZ<#G=w%p_Ww?`QLb{Ydo=v4~3?`hc0pHC$Eb52pz9L z+$~GD;19+xEnAyoPvwA|!OMq~w91F*d3f_8o>k=Z^Gh{)93Mdb@<9Znd@{B>g;FNf zCK57{IV+I7$eozJC8;+b?|Ah9{+_CkmBUqw6t5(CCE%TLz`F>>bBtXHo4}8z*JiF> z>S9Ou;DJ|UAiSfIEZGE1zGaE9hV3qtF`m%LGq*f{DWNS_DcN6Vj-;g27nlEs3^=jN`iHGy3agYf(VWXpz!AGL%PuYSdKLB2~FsFbyqA zJC1FuwPCLeDYpkxc8L-1C{d#kL5!EEW1>@5C;I*bOVYUX$@0#9Gg)59OM?Iu;I3>e zW08%O!b_&E=DB1mtM=Y7oj%eM38OYA&>E>3(whF}@x!n0X*2MWMhd`lwxbbjrvnYJE=dQ}go9lV5rhV_s2{*bOGq*z^rpiNxhmF-}mK2`71S)oFp~?rm5oV|+ zoB8{8wRSGIue=nU2DbNqvy;Xi!ROR)t@0V!Kk>`Ng<82OeG`GB)|`*7Uu}e$qQIQ01EeAG3Azh>IIb$(IV(T(B^%ch_8Y?v)*`(;a&pMU(ixSVLIAo-M zrVEOL^PETTtT!Q^dhF?OtMt>cB61c(i_-c;+VSQd zBE~AvY~MwtlOB!mrJAD2?ik6&E6I$!I-apSZ`&rG)3c4^)`auBTpax_SK+OgZT#F; zAYjrdP?odzrp~%Yab9I28}iD66j&bjZq4B=(G0`s<5EF_Y+G;;2EP zb|L7Ysux$kE_UIHiCawZW%T?wck6Fq@}<=rZ9JdfVF1U=rAG2uj~aDsm#kgMt2mBk zI?(Hh-DW~-CvDXWvd3i29D(6Fu@z*Dmu|~l(Ymh>|5TQtUkVoWHXZ@Ff27z2NQoGi zzW#iAq;uTonffSbPq8@HvwcY&@|q^W3x+&V@$j+|uhu1t=pCUP`wszul-C|gXQE(sa`iaPiEgpR5W0~{; zn=D^&naOvK_Ti`)3cd1n@`0K4DaI~^_i{oryW3@VB$w8Zx=eP?xuA_1fs5iVNaCdY2R{q`64yH5G;PJCuyWB2E>!^r(j27MYW>PT1v1r#_s6cN& zKXX=)j;J__$$Nc(&PrwNioquTT&2)W0yDfeIYDQx(SKzGnP_;8qrK=F*Q!**_%OF7 z5e?m|cb-xnTQv$->$GRbzXO@)YW76I^eo89e9Hz8tI0dPAIvW=!C8z@*s6Gc#fOQ) zMq{L(ZZ-OUfi%k=I6d|$Mo_el2-gK#3%94VoK8;t=PW=BUr}SZA==D}#DaF??3O>p zT?U)NCg~A(n((?U@+PSkc3{tnR!vNTB`kr_MTqwG^E&GH)p7I9b2HQ^Q_=VGjf>qQLwXZIn$L-PUVYc|i_)FH zRdq^%uit&)W7Ig|sCiEYUAE}cn!wmgZQFTPg0~eNj`NHQF-H!m;taT!uF>RWY$37! zVBq`FrP;Pj>zMF;B-t8l)~I?S^E{C~JtihcE3=*BJu^^A34(l~FNRHINx{}!)v{De zki{wvW$o0DXIjQvHuG*ant4|JLi*c1d2W8!Q7WeHi6=h+F7f_B6i9KGj(8T+%8RfL z9$RKGq(OnhLA{Qz-DL`J}HL|yEB_fv8LMFLP=hJqTsl!{h*pbUtm;P z&UN(2Xh?qyek@15kLlPk>B+EoZYAu|z=dlubrKsTarOhiza;PUDtI`h;Zt_cns8|l zYckgWKhfwW_ti!ef!=}un^nH|Z||o2R{6TdSo!gs zxf)~IG<0EkmBJ8$oujoq^Y_y>dm^#cUE{qy0t(~$pc_7j+r?ReI41VJdV4K+TLdyc zFCNTh7}k!#cbu4a{z&d_u=C7D^exeFmx%o+wSV4vX&Ytpa4%t+6)M2KAkRG1+%%>M z`m`rqabH3uK^^RDJ5s2BEHphU-f(hGs9{QB)?1_vozYW|gN_WP+91#HX6vS?mm$@A zv~=eKjxIfyqfNwMrk;uoe;S?JDQq*1mta}o)psvTLZHX58W$Y2X6e5KLu{Uefnyq^ zqY5{Sbk*nDqgiw<)%o?1>o_2R-o z%sKhuGc?@pu<`k$m1yZTjSlW@2h;9yQkh8Su4Km&uj;0ym_%El{iVsXlW7AM)xCE| zZQh@Y5p#>CsZGe*SK-GU^;|ZO_7YYFFuqk<&#lz;%AH%eyp?cEyy5v*)%pLPE!tlT z3ajqV={~-*<$hk6wKi9Zu6w@wf}G=?TO>T*SY9($O_~)Aa12@_CJbn!|l^%IV8N24! z&5AEi9X4|&&r7r0jZNE9b72PV;%Y@pb*L{Du7mNVh~)t0rxuBO&LCEgP0!3p%WUnZ zG0zS=d#LDpK8@>Q5#mlcX>jm9`G3p$?6j3o|I*HUsMjFI+ybCgph z<*LW3LEm+GI@LU%mYx*2HuL*&mXFunsqgYSu3Hc2+W4VY&^74(X1gSrJayTeq1Ecl z=*kdg{0s+U@BXzDcrSt`0V0u^QDl@PwjO1CMJmQ9XtO4ObCK-y-2X_YK0dh%zPDBn zAD3*g67JA7#pxv7>J#*X7>m=#Z}XvyRw`zcIbgNa{o$e#@VY`wH2>I@bXgiI;$qnC z?L)`Dyb{Ub!GCrT>}i3yuCg|tyNK8GC?YT(}E#DpH5i#<1)(@B1G$ZrAi?pn%xuwZ3vJ?J@-?O?_fwSJLH zpNjAL4)~%$X~ffntzUGp?flGfXLf%4xS8X<-S*B-HY~yUee|k;$U^AHtE4k zxrm9a_!hZkQ~Ko-#!H#Dw9+EZD(~nkhzJt_FE7~JtBg|F`NL@93sRjR^BUpFe}11+ z>Z}wKF>>l28=}~~n|y9px8mBC%HFJ{6c*8|gSBEMnFGZY6_Jk*;hnhnh5pr(8QC#8|bX)CW0$_Cwjyi8QciD>`4jGb&%xV$86wdPiAg9YnfnTg{dcH9_o*87Fwv~jx&G6nh0={zk58_c89O{OYgG- z9V_<})#b+3W9IWuq$o9YY8g26WJ)sj)7n`5-2>c)qpH<)N(-$svJ_1sAPnWaqp1fKvab*S+aR zK#9D*IEMx$mqipr&vv&=KBq8}PfWgi3ufP{1bMuNU*m*5i%Q+*k^3_pf25b!ATrtS zGp{`@ymKx5?a;NgKe1Y|yLX}Kp@F@lFIR+sAvM`4xhA{JC3+6YiZthy6Wiyr*4<83 zdN2B`-Z9K39G5z6QI~I01A}^;+mDR8j@Fw8x4?ViER%XmzPLKz`sgo}fff@F<94G= zuiWGHpJ};}o^upNSZPz&n|i0A9+5E3+`GyB-U{M6CB3BVSnk)$*wYUh?cG}rBpdvh z!8tY9c6A9a80mB%{pdQz?62e;T+Oq9yS-cc*LRy)?+&usGTl1A2522!JOUn8n~H5W zGG95iBDv(DN1AF$4dpPDN`tj}l^+_i?6;*9j|LwGoo(Tyk%7TK`t6HFMI1flvsCD< zl1Nt6=Uz#k)R}TcIEE0S#~b?pw+xKQf((BmC~^S0crcFMKJarV)2xH@hEE%~=`o%@is zpfv77noQZVfHp;Dfr@xBX!-!L<$j%;=*iBZc;6aIh-;&o|Z zHh_Sl5CiLAS#*|saWBb!NjN0j`}3N*U3}#Aew|PSYg%aUNK9wO!?*+{c9g82KvbK3 z*6chqcwL=w3&V||n&q${?cs`dzsO157&`B;eLjI*bVOQ21zHbK5@#`D--}oIGl~s^ zDR7gff82RDvVhmJy+Jb(uZmZXp(LB1W#anRJU@*_J4j!>g)-~&mGavbaDiqTrL|;F zUo-ER@z^zu`o+`bdE`Jc?0+M72$Up8%6AF0j)VE3fi|MCOg`nA(@k0u34B|D!>XP| zf^u%Xn`WXqmic1SFo%85oqTr)YM_3q3|G)DHF_?Vp_Btc=tixP(@PHt3^A!D5rg*Q zE-s8)2*KR{lv|B!Q}rKnm*#Y$aUP|9bfT}j$Pm&g7nq7}g?c*Q#gc^WGSGZG3L&Gyeu?uOMDH?hH)>%m$MZGcPbLP(3Y z#>0k&Os{V#^uC@10AIW}e-(?u=m2RGccyq=pLfy<1=L1#RT0Xs2DX^{{ayOrN2<;0 zjYA30N!Y>Q;(G1r9BPg3CI*V-f)`zGUDm~IsB0Id;OmWkpA!|XPLR^FqpZOpprYv< zs@kN`_-GkCiSh;stkh|9ldox~wb1puwc|!ofzqwEF^oj6a|os7Gi*2jm3>ZGJl}d= zE4vG=Jh*0!OCQ`RvubYtdJoE@#k*sOluKHL$QmfPL=EYl!YkuEo>kS}(C#N)OH zTnjU8_(aluseOk77Z{c6lvP$fe~qGuLx0#ILOvu*oUa*NH_;fUXk z&bw~B-@SS2rO%Mz@=3dnyCm`h3fi56YJoosa-r

gA4s7mLZACMFh#$Ykxx(MdS2 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

`p6#d?n6Y#^BN86k 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 Wfq~Ae>3_ptP`jqBnswFu`TqkiWhy=Z literal 56996 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

    1^DI_NfW>c<4BJiSw3Gih!vqu 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 diff --git a/docs/reference/od2line.html b/docs/reference/od2line.html index 5bdcef62..6e7a37be 100644 --- a/docs/reference/od2line.html +++ b/docs/reference/od2line.html @@ -1,360 +1,222 @@ - - - - - - - -Convert origin-destination data to spatial lines — od2line • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + +
    -
    -
    +

+
-
-
-

Convert origin-destination data to spatial lines

- Source: R/od-funs.R - +
+

Convert origin-destination data to spatial lines

+ Source: R/od-funs.R +
od2line.Rd
-
+

Origin-destination ('OD') flow data is often provided in the form of 1 line per flow with zone codes of origin and destination centroids. This can be tricky to plot and link-up with geographical data. This function makes the task easier.

- 
od2line(
-  flow,
-  zones,
-  destinations = NULL,
-  zone_code = names(zones)[1],
-  origin_code = names(flow)[1],
-  dest_code = names(flow)[2],
-  zone_code_d = NA,
-  silent = FALSE
-)
-
-od2line2(flow, zones)
- -

Arguments

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
flow

A data frame representing origin-destination data. +

+

Usage

+ 
od2line(
+  flow,
+  zones,
+  destinations = NULL,
+  zone_code = names(zones)[1],
+  origin_code = names(flow)[1],
+  dest_code = names(flow)[2],
+  zone_code_d = NA,
+  silent = FALSE
+)
+
+ +
+

Arguments

+
flow
+

A data frame representing origin-destination data. The first two columns of this data frame should correspond -to the first column of the data in the zones. Thus in cents(), +to the first column of the data in the zones. Thus in cents_sf(), the first column is geo_code. This corresponds to the first two columns -of flow().

zones

A spatial object representing origins (and destinations -if no separate destinations object is provided) of travel.

destinations

A spatial object -representing destinations of travel flows.

zone_code

Name of the variable in zones containing the ids of the zone. -By default this is the first column names in the zones.

origin_code

Name of the variable in flow containing the ids of the zone of origin. -By default this is the first column name in the flow input dataset.

dest_code

Name of the variable in flow containing the ids of the zone of destination. +of flow().

+ + +
zones
+

A spatial object representing origins (and destinations +if no separate destinations object is provided) of travel.

+ + +
destinations
+

A spatial object +representing destinations of travel flows.

+ + +
zone_code
+

Name of the variable in zones containing the ids of the zone. +By default this is the first column names in the zones.

+ + +
origin_code
+

Name of the variable in flow containing the ids of the zone of origin. +By default this is the first column name in the flow input dataset.

+ + +
dest_code
+

Name of the variable in flow containing the ids of the zone of destination. By default this is the second column name in the flow input dataset or the first column name in the -destinations if that is set.

zone_code_d

Name of the variable in destinations containing the ids of the zone. -By default this is the first column names in the destinations.

silent

TRUE by default, setting it to TRUE will show you the matching columns

- -

Details

+destinations if that is set.

+ +
zone_code_d
+

Name of the variable in destinations containing the ids of the zone. +By default this is the first column names in the destinations.

+ + +
silent
+

TRUE by default, setting it to TRUE will show you the matching columns

+ +
+
+

Details

Origin-destination (OD) data is often provided in the form of 1 line per OD pair, with zone codes of the trip origin in the first column and the zone codes of the destination in the second column -(see the vignette("stplanr-od")) for details. +(see the vignette("stplanr-od")) for details. od2line() creates a spatial (linestring) object representing movement from the origin to the destination for each OD pair. It takes data frame containing origin and destination cones (flow) that match the first column in a a spatial (polygon or point) object (zones).

-

See also

- -

Other od: -dist_google(), -od2odf(), -od_aggregate_from(), -od_aggregate_to(), -od_coords2line(), -od_coords(), -od_dist(), -od_id, -od_oneway(), -od_to_odmatrix(), -odmatrix_to_od(), -points2flow(), -points2odf()

- -

Examples

- 
od_data <- stplanr::flow[1:20, ]
-l <- od2line(flow = od_data, zones = cents_sf)
-plot(sf::st_geometry(cents_sf))
-
plot(l, lwd = l$All / mean(l$All), add = TRUE)
-
#> Warning: ignoring all but the first attribute
l <- od2line(flow = od_data, zones = cents)
-
#> Warning: CRS object has comment, which is lost in output
#> Warning: Discarded datum Unknown based on WGS84 ellipsoid in CRS definition
# When destinations are different
-head(destinations[1:5])
-
#> class       : SpatialPointsDataFrame 
-#> features    : 6 
-#> extent      : -1.540901, -1.492713, 53.80131, 53.81724  (xmin, xmax, ymin, ymax)
-#> crs         : +proj=longlat +ellps=WGS84 +towgs84=0,0,0,0,0,0,0 +no_defs 
-#> variables   : 5
-#> names       :    WZ11CD,   LAD11CD, COWZEW_SG,                     COWZEW_SGN, COWZEW_G 
-#> min values  : E33010351, E08000035,         2, Manufacturing and distribution,       2c 
-#> max values  : E33012352, E08000035,         7,                       Top jobs,       7c 
od_data2 <- flow_dests[1:12, 1:3]
-od_data2
-
#>        Area.of.residence    WZ11CD All
-#> 920573         E02002361 E33010350 109
-#> 920575         E02002361 E33010390  38
-#> 920578         E02002361 E33010468  10
-#> 920582         E02002361 E33012367  44
-#> 920587         E02002361 E33012225  34
-#> 920591         E02002361 E33012368   7
-#> 920601         E02002361 E33012333  94
-#> 921220         E02002363 E33012414  30
-#> 921222         E02002363 E33012313 183
-#> 921225         E02002363 E33010464  11
-#> 921228         E02002363 E33012254  72
-#> 921233         E02002363 E33012352  13
flowlines_dests <- od2line(od_data2, cents_sf, destinations = destinations_sf)
-flowlines_dests
-
#> Simple feature collection with 12 features and 3 fields
-#> geometry type:  LINESTRING
-#> dimension:      XY
-#> bbox:           xmin: -1.563202 ymin: 53.79647 xmax: -1.492713 ymax: 53.83587
-#> geographic CRS: WGS 84
-#> First 10 features:
-#>    Area.of.residence    WZ11CD All                       geometry
-#> 1          E02002361 E33010350 109 LINESTRING (-1.516734 53.82...
-#> 2          E02002361 E33010390  38 LINESTRING (-1.516734 53.82...
-#> 3          E02002361 E33010468  10 LINESTRING (-1.516734 53.82...
-#> 4          E02002361 E33012367  44 LINESTRING (-1.516734 53.82...
-#> 5          E02002361 E33012225  34 LINESTRING (-1.516734 53.82...
-#> 6          E02002361 E33012368   7 LINESTRING (-1.516734 53.82...
-#> 7          E02002361 E33012333  94 LINESTRING (-1.516734 53.82...
-#> 8          E02002363 E33012414  30 LINESTRING (-1.535617 53.82...
-#> 9          E02002363 E33012313 183 LINESTRING (-1.535617 53.82...
-#> 10         E02002363 E33010464  11 LINESTRING (-1.535617 53.82...
plot(flowlines_dests)
-
-
- -
+
+
+

See also

+

Other od: +od2odf(), +od_aggregate_from(), +od_aggregate_to(), +od_coords2line(), +od_coords(), +od_id_order(), +od_id, +od_oneway(), +od_to_odmatrix(), +odmatrix_to_od(), +points2flow(), +points2odf()

+
+ +
+

Examples

+ 
od_data <- stplanr::flow[1:20, ]
+l <- od2line(flow = od_data, zones = cents_sf)
+plot(sf::st_geometry(cents_sf))
+plot(l, lwd = l$All / mean(l$All), add = TRUE)
+#> Warning: ignoring all but the first attribute
+
+
+
+
-
+ - - + + diff --git a/docs/reference/od2odf.html b/docs/reference/od2odf.html index 797417b4..02831426 100644 --- a/docs/reference/od2odf.html +++ b/docs/reference/od2odf.html @@ -1,270 +1,172 @@ - - - - - - - -Extract coordinates from OD data — od2odf • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Extract coordinates from OD data

- Source: R/od-funs.R - +
+

Extract coordinates from OD data

+ Source: R/od-funs.R +
od2odf.Rd
-
+

Extract coordinates from OD data

- 
od2odf(flow, zones)
+
+

Usage

+ 
od2odf(flow, zones)
+
-

Arguments

- - - - - - - - - - -
flow

A data frame representing origin-destination data. +

+

Arguments

+
flow
+

A data frame representing origin-destination data. The first two columns of this data frame should correspond -to the first column of the data in the zones. Thus in cents(), +to the first column of the data in the zones. Thus in cents_sf(), the first column is geo_code. This corresponds to the first two columns -of flow().

zones

A spatial object representing origins (and destinations -if no separate destinations object is provided) of travel.

+of flow().

+ -

Details

+
zones
+

A spatial object representing origins (and destinations +if no separate destinations object is provided) of travel.

+
+
+

Details

Origin-destination (OD) data is often provided in the form of 1 line per OD pair, with zone codes of the trip origin in the first column and the zone codes of the destination in the second column -(see the vignette("stplanr-od")) for details. -od2odf() creates an 'origin-destination data frame', based on a data frame containing -origin and destination cones (flow) that match the first column in a -a spatial (polygon or point) object (zones).

+(see the vignette("stplanr-od")) for details. +od2odf() creates an 'origin-destination data frame', with columns containing +origin and destination codes (flow) that match the first column in a +a spatial (polygon or point sf) object (zones).

The function returns a data frame with coordinates for the origin and destination.

-

See also

- -

Other od: -dist_google(), -od2line(), -od_aggregate_from(), -od_aggregate_to(), -od_coords2line(), -od_coords(), -od_dist(), -od_id, -od_oneway(), -od_to_odmatrix(), -odmatrix_to_od(), -points2flow(), -points2odf()

+
+
+

See also

+

Other od: +od2line(), +od_aggregate_from(), +od_aggregate_to(), +od_coords2line(), +od_coords(), +od_id_order(), +od_id, +od_oneway(), +od_to_odmatrix(), +odmatrix_to_od(), +points2flow(), +points2odf()

+
-

Examples

- 
data(flow)
-data(zones)
-od2odf(flow[1:2, ], zones)
-
#>      code_o    code_d      fx.x     fy.x      fx.y     fy.y
-#> 1 E02002361 E02002361 -1.514962 53.82911 -1.514962 53.82911
-#> 2 E02002361 E02002363 -1.514962 53.82911 -1.535735 53.82863
-
- -
+
+

Examples

+ 
od2odf(flow[1:2, ], zones_sf)
+#> Converting geometry ID from factor to character
+#>             o         d        ox       oy        dx       dy
+#> 1   E02002361 E02002361 -1.514962 53.82911 -1.514962 53.82911
+#> 1.1 E02002361 E02002363 -1.514962 53.82911 -1.535734 53.82863
+
+
+
-
+ - - + + diff --git a/docs/reference/od_coords.html b/docs/reference/od_coords.html index d2923b43..cc0b0908 100644 --- a/docs/reference/od_coords.html +++ b/docs/reference/od_coords.html @@ -1,275 +1,174 @@ - - - - - - - -Create matrices representing origin-destination coordinates — od_coords • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Create matrices representing origin-destination coordinates

- Source: R/od-funs.R - +
+

Create matrices representing origin-destination coordinates

+ Source: R/od-funs.R +
od_coords.Rd
-
+

This function takes a wide range of input data types (spatial lines, points or text strings) and returns a matrix of coordinates representing origin (fx, fy) and destination (tx, ty) points.

- 
od_coords(from = NULL, to = NULL, l = NULL)
- -

Arguments

- - - - - - - - - - - - - - -
from

An object representing origins -(if lines are provided as the first argument, from is assigned to l)

to

An object representing destinations

l

Only needed if from and to are empty, in which case this -should be a spatial object representing desire lines

- -

See also

+
+

Usage

+ 
od_coords(from = NULL, to = NULL, l = NULL)
+
-

Other od: -dist_google(), -od2line(), -od2odf(), -od_aggregate_from(), -od_aggregate_to(), -od_coords2line(), -od_dist(), -od_id, -od_oneway(), -od_to_odmatrix(), -odmatrix_to_od(), -points2flow(), -points2odf()

+
+

Arguments

+
from
+

An object representing origins +(if lines are provided as the first argument, from is assigned to l)

+ + +
to
+

An object representing destinations

+ + +
l
+

Only needed if from and to are empty, in which case this +should be a spatial object representing desire lines

+ +
+
+

See also

+

Other od: +od2line(), +od2odf(), +od_aggregate_from(), +od_aggregate_to(), +od_coords2line(), +od_id_order(), +od_id, +od_oneway(), +od_to_odmatrix(), +odmatrix_to_od(), +points2flow(), +points2odf()

+
-

Examples

- 
od_coords(from = c(0, 52), to = c(1, 53)) # lon/lat coordinates
-
#>      fx fy tx ty
-#> [1,]  0 52  1 53
od_coords(from = cents[1, ], to = cents[2, ]) # Spatial points
-
#>             fx       fy        tx       ty
-#> [1,] -1.546463 53.80952 -1.511861 53.81161
od_coords(cents_sf[1:3, ], cents_sf[2:4, ]) # sf points
-
#>          fx       fy        tx       ty
-#> 1 -1.546463 53.80952 -1.511861 53.81161
-#> 2 -1.511861 53.81161 -1.524205 53.80410
-#> 3 -1.524205 53.80410 -1.550806 53.82442
# od_coords("Hereford", "Leeds") # geocode locations
-od_coords(flowlines[1:3, ])
-
#>             fx       fy        tx       ty
-#> [1,] -1.516734 53.82887 -1.516734 53.82887
-#> [2,] -1.516734 53.82887 -1.535617 53.82847
-#> [3,] -1.516734 53.82887 -1.550807 53.82442
od_coords(flowlines_sf[1:3, ])
-
#>             fx       fy        tx       ty
-#> [1,] -1.516734 53.82887 -1.516734 53.82887
-#> [2,] -1.516734 53.82887 -1.535617 53.82847
-#> [3,] -1.516734 53.82887 -1.550807 53.82442
-
- -
+
+

Examples

+ 
od_coords(from = c(0, 52), to = c(1, 53)) # lon/lat coordinates
+#>      fx fy tx ty
+#> [1,]  0 52  1 53
+od_coords(cents_sf[1:3, ], cents_sf[2:4, ]) # sf points
+#>          fx       fy        tx       ty
+#> 1 -1.546463 53.80952 -1.511861 53.81161
+#> 2 -1.511861 53.81161 -1.524205 53.80410
+#> 3 -1.524205 53.80410 -1.550806 53.82442
+# od_coords("Hereford", "Leeds") # geocode locations
+od_coords(flowlines_sf[1:3, ])
+#>             fx       fy        tx       ty
+#> [1,] -1.516734 53.82887 -1.516734 53.82887
+#> [2,] -1.516734 53.82887 -1.535617 53.82847
+#> [3,] -1.516734 53.82887 -1.550807 53.82442
+
+
+
-
+ - - + + diff --git a/docs/reference/od_id_order.html b/docs/reference/od_id_order.html index a7bd7402..e81095c0 100644 --- a/docs/reference/od_id_order.html +++ b/docs/reference/od_id_order.html @@ -1,254 +1,173 @@ - - - - - - - -Generate ordered ids of OD pairs so lowest is always first -This function is slow on large datasets, see szudzik_pairing for faster alternative — od_id_order • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Generate ordered ids of OD pairs so lowest is always first +
+

Generate ordered ids of OD pairs so lowest is always first This function is slow on large datasets, see szudzik_pairing for faster alternative

- Source: R/oneway.R - + Source: R/oneway.R +
od_id_order.Rd
-
+

Generate ordered ids of OD pairs so lowest is always first This function is slow on large datasets, see szudzik_pairing for faster alternative

- 
od_id_order(x, id1 = names(x)[1], id2 = names(x)[2])
+
+

Usage

+ 
od_id_order(x, id1 = names(x)[1], id2 = names(x)[2])
+
-

Arguments

- - - - - - - - - - - - - - -
x

A data frame or SpatialLinesDataFrame, representing an OD matrix

id1

Optional (it is assumed to be the first column) -text string referring to the name of the variable containing -the unique id of the origin

id2

Optional (it is assumed to be the second column) +

+

Arguments

+
x
+

A data frame or SpatialLinesDataFrame, representing an OD matrix

+ + +
id1
+

Optional (it is assumed to be the first column) text string referring to the name of the variable containing -the unique id of the destination

+the unique id of the origin

-

Examples

- 
x <- data.frame(id1 = c(1, 1, 2, 2, 3), id2 = c(1, 2, 3, 1, 4))
-od_id_order(x) # 4th line switches id1 and id2 so stplanr.key is in order
-
#>   stplanr.id1 stplanr.id1.1 stplanr.key
-#> 1           1             1         1 1
-#> 2           1             2         1 2
-#> 3           2             3         2 3
-#> 4           2             1         1 2
-#> 5           3             4         3 4
-
- -

+
id2
+

Optional (it is assumed to be the second column) +text string referring to the name of the variable containing +the unique id of the destination

+ +
+
+

See also

+

Other od: +od2line(), +od2odf(), +od_aggregate_from(), +od_aggregate_to(), +od_coords2line(), +od_coords(), +od_id, +od_oneway(), +od_to_odmatrix(), +odmatrix_to_od(), +points2flow(), +points2odf()

+
+ +
+

Examples

+ 
x <- data.frame(id1 = c(1, 1, 2, 2, 3), id2 = c(1, 2, 3, 1, 4))
+od_id_order(x) # 4th line switches id1 and id2 so stplanr.key is in order
+#>   stplanr.id1 stplanr.id1.1 stplanr.key
+#> 1           1             1         1 1
+#> 2           1             2         1 2
+#> 3           2             3         2 3
+#> 4           2             1         1 2
+#> 5           3             4         3 4
+
+
+
-
+ - - + + diff --git a/docs/reference/onewaygeo.html b/docs/reference/onewaygeo.html index 140a127f..89d98124 100644 --- a/docs/reference/onewaygeo.html +++ b/docs/reference/onewaygeo.html @@ -1,296 +1,179 @@ - - - - - - - -Aggregate flows so they become non-directional (by geometry - the slow way) — onewaygeo • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ + +
-
-
-

Aggregate flows so they become non-directional (by geometry - the slow way)

- Source: R/overline.R - +
+

Aggregate flows so they become non-directional (by geometry - the slow way)

+ Source: R/overline.R +
onewaygeo.Rd
-
+

Flow data often contains movement in two directions: from point A to point B and then from B to A. This can be problematic for transport planning, because the magnitude of flow along a route can be masked by flows the other direction. If only the largest flow in either direction is captured in an analysis, for example, the true extent of travel will by heavily under-estimated for -OD pairs which have similar amounts of travel in both directions. -Flows in both direction are often represented by overlapping lines with -identical geometries (see flowlines()) which can be confusing -for users and are difficult to plot.

+OD pairs which have similar amounts of travel in both directions.

- 
onewaygeo(x, attrib)
+
+

Usage

+ 
onewaygeo(x, attrib)
+
-

Arguments

- - - - - - - - - - -
x

A dataset containing linestring geometries

attrib

A text string containing the name of the line's attribute to -aggregate or a numeric vector of the columns to be aggregated

+
+

Arguments

+
x
+

A dataset containing linestring geometries

-

Value

-

onewaygeo outputs a SpatialLinesDataFrame with single lines +

attrib
+

A text string containing the name of the line's attribute to +aggregate or a numeric vector of the columns to be aggregated

+ +
+
+

Value

+ + +

onewaygeo outputs a SpatialLinesDataFrame with single lines and user-selected attribute values that have been aggregated. Only lines with a distance (i.e. not intra-zone flows) are included

-

Details

- +
+
+

Details

This function aggregates directional flows into non-directional flows, potentially halving the number of lines objects and reducing the number of overlapping lines to zero.

-

See also

- -

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -points2line(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +points2line(), +toptail_buff()

+
-

Examples

- 
plot(flowlines[1:30, ], lwd = flowlines$On.foot[1:30])
-
singlines <- onewaygeo(flowlines[1:30, ], attrib = which(names(flowlines) == "On.foot"))
-plot(singlines, lwd = singlines$On.foot / 2, col = "red", add = TRUE)
-
if (FALSE) {
-plot(flowlines, lwd = flowlines$All / 10)
-singlelines <- onewaygeo(flowlines, attrib = 3:14)
-plot(singlelines, lwd = singlelines$All / 20, col = "red", add = TRUE)
-sum(singlelines$All) == sum(flowlines$All)
-nrow(singlelines)
-singlelines_sf <- onewaygeo(flowlines_sf, attrib = 3:14)
-sum(singlelines_sf$All) == sum(flowlines_sf$All)
-summary(singlelines$All == singlelines_sf$All)
-}
-
-
- -
+
-
+ - - + + diff --git a/docs/reference/overline-1.png b/docs/reference/overline-1.png index dab435512a76cb27ceb2ca65d224ed9e7ba8b8d1..22ff802e96a47fb0b23ac1c80a242f2ef8484a5b 100644 GIT binary patch literal 31316 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 Io`0 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%0D*URrW-0e+5eGYO7Ng(#yR~+F@mg7Dp|J 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 diff --git a/docs/reference/overline-2.png b/docs/reference/overline-2.png index 2d03135ffdd3b605af308536d5f7c24591391b32..616e073342dbd7d13821c3bffb0fd411d4393483 100644 GIT binary patch literal 48895 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 literal 48795 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 diff --git a/docs/reference/overline.html b/docs/reference/overline.html index 4fe5f5d0..f7afffee 100644 --- a/docs/reference/overline.html +++ b/docs/reference/overline.html @@ -1,239 +1,154 @@ - - - - - - - -Convert series of overlapping lines into a route network — overline • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert series of overlapping lines into a route network

- Source: R/overline.R - +
+

Convert series of overlapping lines into a route network

+ Source: R/overline.R +
overline.Rd
-
+

This function takes a series of overlapping lines and converts them into a single route network.

This function is intended as a replacement for overline() and is significantly faster especially on large datasets. However, it also uses more memory.

- 
overline(
-  sl,
-  attrib,
-  ncores = 1,
-  simplify = TRUE,
-  regionalise = 1e+05,
-  quiet = ifelse(nrow(sl) < 1000, TRUE, FALSE),
-  fun = sum
-)
-
-overline2(
-  sl,
-  attrib,
-  ncores = 1,
-  simplify = TRUE,
-  regionalise = 1e+05,
-  quiet = ifelse(nrow(sl) < 1000, TRUE, FALSE),
-  fun = sum
-)
- -

Arguments

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
sl

A spatial object representing routes on a transport network

attrib

character, column names in sl to be aggregated

ncores

integer, how many cores to use in parallel processing, default = 1

simplify

logical, if TRUE group final segments back into lines, default = TRUE

regionalise

integer, during simplification regonalisation is used if the number of segments exceeds this value

quiet

Should the the function omit messages? NULL by default, -which means the output will only be shown if sl has more than 1000 rows.

fun

Named list of functions to summaries the attributes by? sum is the default. -list(sum = sum, average = mean) will summarise all attributes by sum and mean.

- -

Value

- -

An sf object representing a route network

-

Details

+
+

Usage

+ 
overline(
+  sl,
+  attrib,
+  ncores = 1,
+  simplify = TRUE,
+  regionalise = 1e+09,
+  quiet = ifelse(nrow(sl) < 1000, TRUE, FALSE),
+  fun = sum
+)
+
+overline2(
+  sl,
+  attrib,
+  ncores = 1,
+  simplify = TRUE,
+  regionalise = 1e+09,
+  quiet = ifelse(nrow(sl) < 1000, TRUE, FALSE),
+  fun = sum
+)
+
+ +
+

Arguments

+
sl
+

A spatial object representing routes on a transport network

+ + +
attrib
+

character, column names in sl to be aggregated

+ + +
ncores
+

integer, how many cores to use in parallel processing, default = 1

+ + +
simplify
+

logical, if TRUE group final segments back into lines, default = TRUE

+ +
regionalise
+

integer, during simplification regonalisation is used if the number of segments exceeds this value

+ + +
quiet
+

Should the the function omit messages? NULL by default, +which means the output will only be shown if sl has more than 1000 rows.

+ + +
fun
+

Named list of functions to summaries the attributes by? sum is the default. +list(sum = sum, average = mean) will summarise all attributes by sum and mean.

+ +
+
+

Value

+ + +

An sf object representing a route network

+
+
+

Details

The function can be used to estimate the amount of transport 'flow' at the route segment level based on input datasets from routing services, for -example linestring geometries created with the route() function.

+example linestring geometries created with the route() function.

The overline() function breaks each line into many straight segments and then looks for duplicated segments. Attributes are summed for all duplicated segments, and if simplify is TRUE the segments with identical attributes are recombined into linestrings.

-

The following arguments only apply to the sf implementation of overline():

    -

  • ncores, the number of cores to use in parallel processing

    • +

    The following arguments only apply to the sf implementation of overline():

    • ncores, the number of cores to use in parallel processing

    • simplify, should the final segments be converted back into longer lines? The default setting is TRUE. simplify = FALSE results in straight line segments consisting of only 2 vertices (the start and end point), resulting in a data frame with many more rows than the simplified results (see examples).

    • regionalise the threshold number of rows above which regionalisation is used (see details).

      • -
    - -

    For sf objects Regionalisation breaks the dataset into a 10 x 10 grid and +

For sf objects Regionalisation breaks the dataset into a 10 x 10 grid and then performed the simplification across each grid. This significantly reduces computation time for large datasets, but slightly increases the final file size. For smaller datasets it increases computation time slightly but @@ -247,142 +162,112 @@

Details results together, and then overline again, to produce a final result.

Multicore support is only enabled for the regionalised simplification stage as it does not help with other stages.

-

References

- +
+
+

References

Morgan M and Lovelace R (2020). Travel flow aggregation: Nationally scalable methods for interactive and online visualisation of transport behaviour at the road network level. Environment and Planning B: Urban Analytics and City Science. July 2020. -doi:10.1177/2399808320942779

+doi:10.1177/2399808320942779 +.

Rowlingson, B (2015). Overlaying lines and aggregating their values for overlapping -segments. Reproducible question from https://gis.stackexchange.com. See -https://gis.stackexchange.com/questions/139681/.

-

See also

- -

Other rnet: -SpatialLinesNetwork, -calc_catchment_sum(), -calc_catchment(), -calc_moving_catchment(), -calc_network_catchment(), -find_network_nodes(), -gsection(), -islines(), -lineLabels(), -overline_spatial(), -plot,SpatialLinesNetwork,ANY-method, -plot,sfNetwork,ANY-method, -rnet_breakup_vertices(), -rnet_group(), -sln2points(), -sum_network_links(), -sum_network_routes()

+segments. Reproducible question from https://gis.stackexchange.com. See +https://gis.stackexchange.com/questions/139681/.

+
+
+

See also

+

Other rnet: +gsection(), +islines(), +rnet_breakup_vertices(), +rnet_group()

Other rnet: -SpatialLinesNetwork, -calc_catchment_sum(), -calc_catchment(), -calc_moving_catchment(), -calc_network_catchment(), -find_network_nodes(), -gsection(), -islines(), -lineLabels(), -overline_spatial(), -plot,SpatialLinesNetwork,ANY-method, -plot,sfNetwork,ANY-method, -rnet_breakup_vertices(), -rnet_group(), -sln2points(), -sum_network_links(), -sum_network_routes()

-

Author

- +gsection(), +islines(), +rnet_breakup_vertices(), +rnet_group()

+
+
+

Author

Barry Rowlingson

Malcolm Morgan

+
-

Examples

- 
sl <- routes_fast_sf[2:4, ]
-sl$All <- flowlines$All[2:4]
-rnet <- overline(sl = sl, attrib = "All")
-nrow(sl)
-
#> [1] 3
nrow(rnet)
-
#> [1] 4
plot(rnet)
-
rnet_mean <- overline(sl, c("All", "av_incline"), fun = list(mean = mean, sum = sum))
-plot(rnet_mean, lwd = rnet_mean$All_sum / mean(rnet_mean$All_sum))
-
rnet_sf_raw <- overline(sl, attrib = "length", simplify = FALSE)
-nrow(rnet_sf_raw)
-
#> [1] 151
summary(n_vertices(rnet_sf_raw))
-
#>    Min. 1st Qu.  Median    Mean 3rd Qu.    Max. 
-#>       2       2       2       2       2       2 
plot(rnet_sf_raw)
-
rnet_sf_raw$n = 1:nrow(rnet_sf_raw)
-plot(rnet_sf_raw[10:25, ])
-
# legacy implementation based on sp data
-# sl <- routes_fast[2:4, ]
-# rnet1 <- overline(sl = sl, attrib = "length")
-# rnet2 <- overline(sl = sl, attrib = "length", buff_dist = 1)
-# plot(rnet1, lwd = rnet1$length / mean(rnet1$length))
-# plot(rnet2, lwd = rnet2$length / mean(rnet2$length))
-
-
- -
+
+

Examples

+ 
sl <- routes_fast_sf[2:4, ]
+sl$All <- flowlines_sf$All[2:4]
+rnet <- overline(sl = sl, attrib = "All")
+nrow(sl)
+#> [1] 3
+nrow(rnet)
+#> [1] 4
+plot(rnet)
+
+rnet_mean <- overline(sl, c("All", "av_incline"), fun = list(mean = mean, sum = sum))
+plot(rnet_mean, lwd = rnet_mean$All_sum / mean(rnet_mean$All_sum))
+
+rnet_sf_raw <- overline(sl, attrib = "length", simplify = FALSE)
+nrow(rnet_sf_raw)
+#> [1] 151
+summary(n_vertices(rnet_sf_raw))
+#>    Min. 1st Qu.  Median    Mean 3rd Qu.    Max. 
+#>       2       2       2       2       2       2 
+plot(rnet_sf_raw)
+
+rnet_sf_raw$n <- 1:nrow(rnet_sf_raw)
+plot(rnet_sf_raw[10:25, ])
+
+
+
+
-
+ - - + + diff --git a/docs/reference/pipe.html b/docs/reference/pipe.html index 2fd7cedb..1c493f3c 100644 --- a/docs/reference/pipe.html +++ b/docs/reference/pipe.html @@ -1,220 +1,120 @@ - - - - - - - -Pipe operator — %>% • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Pipe operator

- Source: R/utils-pipe.R - +
+

Pipe operator

+ Source: R/utils-pipe.R +
pipe.Rd
-
+

See ?magrittr for details.

- 
lhs %>% rhs
- +
+

Usage

+ 
lhs %>% rhs
+
-
- -
+
-
+ - - + + diff --git a/docs/reference/points2flow-1.png b/docs/reference/points2flow-1.png index 0dbf519888af07dcbd1e3b309ad7ef1abd5b9bf2..c3617ba3ff66001a48f5da38a086f026dd5f2bc6 100644 GIT binary patch literal 63853 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 literal 53166 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 diff --git a/docs/reference/points2flow.html b/docs/reference/points2flow.html index 90cc8235..5bcf7cd5 100644 --- a/docs/reference/points2flow.html +++ b/docs/reference/points2flow.html @@ -1,256 +1,156 @@ - - - - - - - -Convert a series of points into geographical flows — points2flow • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert a series of points into geographical flows

- Source: R/od-funs.R - +
+

Convert a series of points into geographical flows

+ Source: R/od-funs.R +
points2flow.Rd
-
+

Takes a series of geographical points and converts them into a spatial (linestring) object representing the potential flows, or 'spatial interaction', between every combination of points.

- 
points2flow(p)
- -

Arguments

- - - - - - -
p

A spatial (point) object

- -

See also

+
+

Usage

+ 
points2flow(p)
+
-

Other od: -dist_google(), -od2line(), -od2odf(), -od_aggregate_from(), -od_aggregate_to(), -od_coords2line(), -od_coords(), -od_dist(), -od_id, -od_oneway(), -od_to_odmatrix(), -odmatrix_to_od(), -points2odf()

+
+

Arguments

+
p
+

A spatial (point) object

+ +
+
+

See also

+

Other od: +od2line(), +od2odf(), +od_aggregate_from(), +od_aggregate_to(), +od_coords2line(), +od_coords(), +od_id_order(), +od_id, +od_oneway(), +od_to_odmatrix(), +odmatrix_to_od(), +points2odf()

+
-

Examples

- 
data(cents)
-plot(cents)
-
flow <- points2flow(cents)
-
#> Warning: CRS object has comment, which is lost in output
#> Warning: Discarded datum Unknown based on WGS84 ellipsoid in CRS definition
plot(flow, add = TRUE)
-
flow_sf <- points2flow(cents_sf)
-plot(flow_sf)
-
-
- -
+
+

Examples

+ 
flow_sf <- points2flow(cents_sf[1:4, ])
+plot(flow_sf)
+
+
+
+
-
+ - - + + diff --git a/docs/reference/points2line-1.png b/docs/reference/points2line-1.png index 7b84148ce409f6810af785fe008933a9a175e8f1..02bfd11f87bb7db63b2eb7801bd99b1557f21dae 100644 GIT binary patch literal 302165 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 z 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 VDxIz=Dm@ncnT9S5`?vK!{|l5v@W}uG literal 6010 zcmeAS@N?(olHy`uVBq!ia0y~yV69+aU{2y-1B%?9w(tXxVoUONcLCBs@Y8vBJ&@uo z@Q5sCV32JGVaEQaA5$3^#HBo4978JRyt%Q_(}j_N^&tBp#fYAW8Ll(qGL)w!Dug90 zSUKa)`F-5RqB(n{!KRH8qaiRF0z)SR3J%}B$q01rhx4)9Z1aEL`c_xO4R$?y?6$pm zzwedV?qmh=8=C9R-#wq(|NI$Pw&2M9oxe-+_`n?Z8N0!><1;-F?J!{{*a(4?cT6BY z%gj;f(O_X1O%9{kU^E+yW`oh%08}ZCR+6KQ15i2`Z8MFw6@kfMw2eI4bpR%V5!*)o zYE&!^Dh?H1=H5PjCKkkOnDaZAKiwU~90emU1P=ID7kGfYt?=T1cD}^O3xH7{58@C= YQ0Tts>T{p>v@yt$p00i_>zopr0EJ!bkN^Mx diff --git a/docs/reference/points2line.html b/docs/reference/points2line.html index 443c190c..8ef892d7 100644 --- a/docs/reference/points2line.html +++ b/docs/reference/points2line.html @@ -1,265 +1,155 @@ - - - - - - - -Convert a series of points, or a matrix of coordinates, into a line — points2line • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- - - - - - -
-
-
+
+ +

h1gvUr~>Y;3~avSAfI30OzH2@U}0Cx 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�Fv{kdL5WldM%iQ0z2@->*m6zD!K7Cmd6kxtUx* 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 z

+
-
-
-

Convert a series of points, or a matrix of coordinates, into a line

- Source: R/od-funs.R - +
+

Convert a series of points, or a matrix of coordinates, into a line

+ Source: R/od-funs.R +
points2line.Rd
-
-

This is a simple wrapper around spLines() that makes the creation of -SpatialLines objects easy and intuitive

+
+

This function makes that makes the creation of sf +objects with LINESTRING geometries easy.

- 
points2line(p)
- -

Arguments

- - - - - - -
p

A spatial (points) obect or matrix representing the coordinates of points.

- -

See also

+
+

Usage

+ 
points2line(p)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -toptail_buff(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
p
+

A spatial (points) obect or matrix representing the coordinates of points.

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +toptail_buff()

+
-

Examples

- 
p <- matrix(1:4, ncol = 2)
-library(sp)
-l <- points2line(p)
-plot(l)
-
l <- points2line(cents)
-
#> Warning: CRS object has comment, which is lost in output
#> Warning: Discarded datum Unknown based on WGS84 ellipsoid in CRS definition
plot(l)
-
p <- line2points(routes_fast)
-
#> Warning: CRS object has comment, which is lost in output
#> Warning: Discarded datum Unknown based on WGS84 ellipsoid in CRS definition
l <- points2line(p)
-
#> Warning: CRS object has comment, which is lost in output
#> Warning: Discarded datum Unknown based on WGS84 ellipsoid in CRS definition
plot(l)
-
l_sf <- points2line(cents_sf)
-plot(l_sf)
-
-
- -
+
+

Examples

+ 
l_sf <- points2line(cents_sf)
+plot(l_sf)
+
+
+
+
-
+ - - + + diff --git a/docs/reference/points2odf.html b/docs/reference/points2odf.html index d09888f6..123bf013 100644 --- a/docs/reference/points2odf.html +++ b/docs/reference/points2odf.html @@ -1,255 +1,219 @@ - - - - - - - -Convert a series of points into a dataframe of origins and destinations — points2odf • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Convert a series of points into a dataframe of origins and destinations

- Source: R/od-funs.R - +
+

Convert a series of points into a dataframe of origins and destinations

+ Source: R/od-funs.R +
points2odf.Rd
-
+

Takes a series of geographical points and converts them into a data.frame representing the potential flows, or 'spatial interaction', between every combination of points.

- 
points2odf(p)
- -

Arguments

- - - - - - -
p

A spatial points object

- -

See also

+
+

Usage

+ 
points2odf(p)
+
-

Other od: -dist_google(), -od2line(), -od2odf(), -od_aggregate_from(), -od_aggregate_to(), -od_coords2line(), -od_coords(), -od_dist(), -od_id, -od_oneway(), -od_to_odmatrix(), -odmatrix_to_od(), -points2flow()

+
+

Arguments

+
p
+

A spatial points object

+ +
+
+

See also

+

Other od: +od2line(), +od2odf(), +od_aggregate_from(), +od_aggregate_to(), +od_coords2line(), +od_coords(), +od_id_order(), +od_id, +od_oneway(), +od_to_odmatrix(), +odmatrix_to_od(), +points2flow()

+
-

Examples

- 
data(cents)
-df <- points2odf(cents)
-cents_centroids <- rgeos::gCentroid(cents, byid = TRUE)
-df2 <- points2odf(cents_centroids)
-df3 <- points2odf(cents_sf)
-
-
- -
+
+

Examples

+ 
points2odf(cents_sf)
+#>            O         D
+#> 1  E02002384 E02002384
+#> 2  E02002384 E02002382
+#> 3  E02002384 E02002393
+#> 4  E02002384 E02002367
+#> 5  E02002384 E02002363
+#> 6  E02002384 E02002361
+#> 7  E02002384 E02002377
+#> 8  E02002384 E02002371
+#> 9  E02002382 E02002384
+#> 10 E02002382 E02002382
+#> 11 E02002382 E02002393
+#> 12 E02002382 E02002367
+#> 13 E02002382 E02002363
+#> 14 E02002382 E02002361
+#> 15 E02002382 E02002377
+#> 16 E02002382 E02002371
+#> 17 E02002393 E02002384
+#> 18 E02002393 E02002382
+#> 19 E02002393 E02002393
+#> 20 E02002393 E02002367
+#> 21 E02002393 E02002363
+#> 22 E02002393 E02002361
+#> 23 E02002393 E02002377
+#> 24 E02002393 E02002371
+#> 25 E02002367 E02002384
+#> 26 E02002367 E02002382
+#> 27 E02002367 E02002393
+#> 28 E02002367 E02002367
+#> 29 E02002367 E02002363
+#> 30 E02002367 E02002361
+#> 31 E02002367 E02002377
+#> 32 E02002367 E02002371
+#> 33 E02002363 E02002384
+#> 34 E02002363 E02002382
+#> 35 E02002363 E02002393
+#> 36 E02002363 E02002367
+#> 37 E02002363 E02002363
+#> 38 E02002363 E02002361
+#> 39 E02002363 E02002377
+#> 40 E02002363 E02002371
+#> 41 E02002361 E02002384
+#> 42 E02002361 E02002382
+#> 43 E02002361 E02002393
+#> 44 E02002361 E02002367
+#> 45 E02002361 E02002363
+#> 46 E02002361 E02002361
+#> 47 E02002361 E02002377
+#> 48 E02002361 E02002371
+#> 49 E02002377 E02002384
+#> 50 E02002377 E02002382
+#> 51 E02002377 E02002393
+#> 52 E02002377 E02002367
+#> 53 E02002377 E02002363
+#> 54 E02002377 E02002361
+#> 55 E02002377 E02002377
+#> 56 E02002377 E02002371
+#> 57 E02002371 E02002384
+#> 58 E02002371 E02002382
+#> 59 E02002371 E02002393
+#> 60 E02002371 E02002367
+#> 61 E02002371 E02002363
+#> 62 E02002371 E02002361
+#> 63 E02002371 E02002377
+#> 64 E02002371 E02002371
+
+
+
-
+ - - + + diff --git a/docs/reference/quadrant-1.png b/docs/reference/quadrant-1.png index 8f6f9ce45b9d074d241ef7f156fa5a59a874decc..9a5adbaa9a6cbb4cf44dc50cc0f2b443601f6391 100644 GIT binary patch literal 36526 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 k!2f9A|C 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�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 - - - - - - -Split a spatial object into quadrants — quadrant • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

- - - - - - - + +
-
-
+
+
-
-
-

Split a spatial object into quadrants

- Source: R/quadrants.R - +
+

Split a spatial object into quadrants

+ Source: R/quadrants.R +
quadrant.Rd
-
-

Split a spatial object (initially tested on SpatialPolygons) into quadrants.

+
+

Returns a character vector of NE, SE, SW, NW corresponding to north-east, south-east +quadrants respectively. If number_out is TRUE, returns numbers from 1:4, respectively.

- 
quadrant(sp_obj, number_out = FALSE)
+
+

Usage

+ 
quadrant(x, cent = NULL, number_out = FALSE)
+
-

Arguments

- - - - - - - - - - -
sp_obj

Spatial object

number_out

Should the output be numbers from 1:4 (FALSE by default)

+
+

Arguments

+
x
+

Object of class sf

-

Details

-

Returns a character vector of NE, SE, SW, NW corresponding to north-east, south-east -quadrants respectively. If number_out is TRUE, returns numbers from 1:4, respectively.

-

See also

+
cent
+

The centrepoint of the region of interest. +Quadrants will be defined based on this point. +By default this will be the geographic centroid of the zones.

-

Other geo: -bbox_scale(), -gclip(), -geo_bb_matrix(), -geo_bb(), -mapshape_available(), -mapshape(), -reproject()

-

Examples

- 
data(zones)
-sp_obj <- zones
-(quads <- quadrant(sp_obj))
-
#> [1] "SE" "SW" "SE" "NE" "NE" "SW" "NW" "SE"
plot(sp_obj, col = factor(quads))
-
points(rgeos::gCentroid(sp_obj), col = "white")
-
# edge cases (e.g. when using rasters) lead to NAs
-sp_obj <- raster::rasterToPolygons(raster::raster(ncol = 3, nrow = 3))
-(quads <- quadrant(sp_obj))
-
#> [1] "SW" NA   "NE" NA   NA   NA   "NW" NA   "SE"
plot(sp_obj, col = factor(quads))
-
-
- -
+
number_out
+

Should the result be returned as a number?

+ +
+
+

See also

+

Other geo: +bbox_scale(), +geo_bb_matrix(), +geo_bb(), +geo_buffer(), +geo_length(), +geo_projected(), +geo_select_aeq()

+
+ +
+

Examples

+ 
x = zones_sf
+(quads <- quadrant(x))
+#> Warning: st_centroid assumes attributes are constant over geometries of x
+#> [1] "SE" "SW" "SE" "NE" "NE" "SW" "NW" "SE"
+plot(x$geometry, col = factor(quads))
+
+
+
+
-
+ - - + + diff --git a/docs/reference/read_table_builder.html b/docs/reference/read_table_builder.html index 5704c780..71a88b77 100644 --- a/docs/reference/read_table_builder.html +++ b/docs/reference/read_table_builder.html @@ -1,189 +1,101 @@ - - - - - - - -Import and format Australian Bureau of Statistics (ABS) TableBuilder files — read_table_builder • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +Import and format Australian Bureau of Statistics (ABS) TableBuilder files — read_table_builder • stplanr + Skip to contents + - - - - - +
-
-
-

Import and format Australian Bureau of Statistics (ABS) TableBuilder files

- Source: R/loadABS.R - +
+

Import and format Australian Bureau of Statistics (ABS) TableBuilder files

+ Source: R/loadABS.R +
read_table_builder.Rd
-
+

Import and format Australian Bureau of Statistics (ABS) TableBuilder files

- 
read_table_builder(dataset, filetype = "csv", sheet = 1, removeTotal = TRUE)
+
+

Usage

+ 
read_table_builder(dataset, filetype = "csv", sheet = 1, removeTotal = TRUE)
+
-

Arguments

- - - - - - - - - - - - - - - - - - -
dataset

Either a dataframe containing the original data from +

+

Arguments

+
dataset
+

Either a dataframe containing the original data from TableBuilder or a character string containing the path of the -unzipped TableBuilder file.

filetype

A character string containing the filetype. Valid values +unzipped TableBuilder file.

+ + +
filetype
+

A character string containing the filetype. Valid values are 'csv', 'legacycsv' and 'xlsx' (default = 'csv'). Required even when dataset is a dataframe. Use 'legacycsv' for csv files derived from earlier versions of TableBuilder for which csv outputs were csv versions of the xlsx files. Current csv output from TableBuilder follow a more standard -csv format.

sheet

An integer value containing the index of the sheet in the -xlsx file (default = 1).

removeTotal

A boolean value. If TRUE removes the rows and columns -with totals (default = TRUE).

+csv format.

+ + +
sheet
+

An integer value containing the index of the sheet in the +xlsx file (default = 1).

-

Details

+
removeTotal
+

A boolean value. If TRUE removes the rows and columns +with totals (default = TRUE).

+ +
+
+

Details

The Australian Bureau of Statistics (ABS) provides customised tables for @@ -191,80 +103,77 @@

Details because it contains rows with additional information. This function imports the original (unzipped) TableBuilder files in .csv or .xlsx format before creating an R dataframe with the data.

+

Note: we recommend using the +readabs +package for this purpose.

+

+
+

See also

+

Other data: +cents_sf, +destinations_sf, +flow_dests, +flowlines_sf, +flow, +od_data_lines, +od_data_routes, +od_data_sample, +osm_net_example, +route_network_sf, +route_network_small, +routes_fast_sf, +routes_slow_sf, +zones_sf

+
-

Examples

- 
data_dir <- system.file("extdata", package = "stplanr")
-t1 <- read_table_builder(file.path(data_dir, "SA1Population.csv"))
-if(requireNamespace("openxlsx")) {
-  t2 <- read_table_builder(file.path(data_dir, "SA1Population.xlsx"),
-    filetype = "xlsx", sheet = 1, removeTotal = TRUE
-)
-}
-
#> Loading required namespace: openxlsx
f <- file.path(data_dir, "SA1Population.csv")
-sa1pop <- read.csv(f, stringsAsFactors = TRUE, header = FALSE)
-t3 <- read_table_builder(sa1pop)
-
-
- -
+
-
+ - - + + diff --git a/docs/reference/route.html b/docs/reference/route.html index cea975e2..508f623e 100644 --- a/docs/reference/route.html +++ b/docs/reference/route.html @@ -1,303 +1,194 @@ - - - - - - - -Plan routes on the transport network — route • stplanr - - - - - +Plan routes on the transport network — route • stplanr + Skip to contents + + +
+
+
+

Plan routes on the transport network

+ Source: R/route.R +
route.Rd
+
+
+

Takes origins and destinations, finds the optimal routes between them +and returns the result as a spatial (sf or sp) object. +The definition of optimal depends on the routing function used

+
+
+

Usage

+ 
route(
+  from = NULL,
+  to = NULL,
+  l = NULL,
+  route_fun = cyclestreets::journey,
+  wait = 0,
+  n_print = 10,
+  list_output = FALSE,
+  cl = NULL,
+  ...
+)
+
- - - +
+

Arguments

+
from
+

An object representing origins +(if lines are provided as the first argument, from is assigned to l)

- - - - - - +
to
+

An object representing destinations

- - - - - +
l
+

A spatial (linestring) object

- - - - - +
route_fun
+

A routing function to be used for converting the lines to routes

- - - +
wait
+

How long to wait between routes? +0 seconds by default, can be useful when sending requests to rate limited APIs.

+
n_print
+

A number specifying how frequently progress updates +should be shown

+
list_output
+

If FALSE (default) assumes spatial (linestring) object output. +Set to TRUE to save output as a list.

- - - - - - +
cl
+

Cluster

- - -
-
- - - - -
- -
-
-
-

Plan routes on the transport network

- Source: R/route.R - +
+
+

See also

+

Other routes: +route_dodgr(), +route_osrm()

+

Other routes: +route_dodgr(), +route_osrm()

-
-

Takes origins and destinations, finds the optimal routes between them -and returns the result as a spatial (sf or sp) object. -The definition of optimal depends on the routing function used

+
+

Examples

+ 
# Todo: add examples
+
+
- - 
route(
-  from = NULL,
-  to = NULL,
-  l = NULL,
-  route_fun = cyclestreets::journey,
-  n_print = 10,
-  list_output = FALSE,
-  cl = NULL,
-  ...
-)
- -

Arguments

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
from

An object representing origins -(if lines are provided as the first argument, from is assigned to l)

to

An object representing destinations

l

Only needed if from and to are empty, in which case this -should be a spatial object representing desire lines

route_fun

A routing function to be used for converting the straight lines to routes -od2line()

n_print

A number specifying how frequently progress updates -should be shown

list_output

If FALSE (default) assumes spatial (linestring) object output. Set to TRUE to save output as a list.

cl

Cluster

...

Arguments passed to the routing function, e.g. route_cyclestreets()

- -

See also

- -

Other routes: -line2routeRetry(), -line2route(), -route_dodgr(), -route_local(), -route_transportapi_public()

- -

Examples

- 
library(osrm)
-
#> Data: (c) OpenStreetMap contributors, ODbL 1.0 - http://www.openstreetmap.org/copyright
#> Routing: OSRM - http://project-osrm.org/
r_osrm <- route(
-  from = c(-0.11, 51.514),
-  to = c(-0.10, 51.506),
-  route_fun = osrmRoute,
-  returnclass = "sf"
-)
-
#> Most common output is sf
r <- overline(routes_fast_sf[2:5, ], "length")
-l <- od2line(od_data_sample[2:5, 1:3], cents_sf)
-sln <- stplanr::SpatialLinesNetwork(r)
-# calculate shortest paths
-plot(sln)
-
plot(l$geometry, add = TRUE)
-
r_local <- stplanr::route(
-  l = l,
-  route_fun = stplanr::route_local,
-  sln = sln
-)
-
#> Most common output is sf
library(sf) # for plotting
-plot(r_local["all"], add = TRUE, lwd = 5)
-
-
- -
+
-
+ - - + + diff --git a/docs/reference/route_osrm.html b/docs/reference/route_osrm.html index 16ac8a2c..ce0cbeee 100644 --- a/docs/reference/route_osrm.html +++ b/docs/reference/route_osrm.html @@ -1,212 +1,200 @@ - - - - - - - -Plan a route with OSRM — route_osrm • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - +Plan routes on the transport network using the OSRM server — route_osrm • stplanr + Skip to contents + +
-
-
-

Plan a route with OSRM

- Source: R/osrmfunctions.R - +
+

Plan routes on the transport network using the OSRM server

+ Source: R/route_osrm.R +
route_osrm.Rd
-
- -

This is a wrapper around viaroute that returns a single route between A and B.

- +
+

This function is a simplified and (because it uses GeoJSON not binary polyline format) +slower R interface to OSRM routing services compared with the excellent +osrm::osrmRoute() function (which can be used via the route()) function.

- 
route_osrm(from, to, l = NULL, alt = FALSE, ..., singleline = TRUE)
- -

Arguments

- - - - - - - - - - - - - - - - - - - - - - - - - - -
from

Text string or coordinates (a numeric vector of -length = 2 representing latitude and longitude) representing a point -on Earth.

to

Text string or coordinates (a numeric vector of -length = 2 representing latitude and longitude) representing a point -on Earth. This represents the destination of the trip.

l

Only needed if from and to are empty, in which case this -should be a spatial object representing desire lines

alt

Boolean value to return alternative routes (default = TRUE).

...

Arguments passed to viaroute()

singleline

Should a single line be returned? Default is TRUE

- -

Note

+
+

Usage

+ 
route_osrm(
+  from,
+  to,
+  osrm.server = "https://routing.openstreetmap.de/",
+  osrm.profile = "foot"
+)
+
-

The public-facing OSRM routing service (the default) -only provides routing for cars by default. For details, see -https://github.com/Project-OSRM/osrm-backend/issues/4530.

- +
+

Arguments

+
from
+

An object representing origins +(if lines are provided as the first argument, from is assigned to l)

-

Examples

- 
# NOT RUN {
-from <- c(-1.55, 53.80) # geo_code("leeds")
-to <- c(-1.76, 53.80) # geo_code("bradford uk")
-r <- route_osrm(from, to)
-plot(r)
-r_many <- line2route(flowlines_sf[2:9, ], route_osrm)
-plot(cents)
-plot(r_many, add = TRUE)
-# }
-
- -
+
to
+

An object representing destinations

-
-
-

Developed by Robin Lovelace, Richard Ellison.

-
-
-

Site built with pkgdown.

+
osrm.server
+

The base URL of the routing server. +getOption("osrm.server") by default.

+ + +
osrm.profile
+

The routing profile to use, e.g. "car", "bike" or "foot" +(when using the routing.openstreetmap.de test server). +getOption("osrm.profile") by default.

+ + +
profile
+

Which routing profile to use? One of "foot" (default) +"bike" or "car" for the default open server.

+ +
+
+

See also

+

Other routes: +route_dodgr(), +route()

+
+ +
+

Examples

+ 
# \donttest{
+# Examples no longer working due to API being down
+# l1 = od_data_lines[49, ]
+# l1m = od_coords(l1)
+# from = l1m[, 1:2]
+# to = l1m[, 3:4]
+# if(curl::has_internet()) {
+# r_foot = route_osrm(from, to)
+# r_bike = route_osrm(from, to, osrm.profile = "bike")
+# r_car = route_osrm(from, to, osrm.profile = "car")
+# plot(r_foot$geometry, lwd = 9, col = "grey")
+# plot(r_bike, col = "blue", add = TRUE)
+# plot(r_car, col = "red", add = TRUE)
+# }
+# }
+
+
+
+
+ + + -
+ +
+ + - - + diff --git a/docs/reference/stplanr-package.html b/docs/reference/stplanr-package.html index c8d2dede..21185220 100644 --- a/docs/reference/stplanr-package.html +++ b/docs/reference/stplanr-package.html @@ -1,239 +1,131 @@ - - - - - - - -stplanr: Sustainable Transport Planning with R — stplanr-package • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - +route allocation and modelling travel patterns.">stplanr: Sustainable Transport Planning with R — stplanr-package • stplanr + Skip to contents + - - - - - +
-
-
-

stplanr: Sustainable Transport Planning with R

- Source: R/stplanr-package.R - +
+

stplanr: Sustainable Transport Planning with R

+ Source: R/stplanr-package.R +
stplanr-package.Rd
-
+

The stplanr package provides functions to access and analyse data for transportation research, including origin-destination analysis, route allocation and modelling travel patterns.

+
+

See also

+

https://github.com/ropensci/stplanr

+
+
+

Author

+

Robin Lovelace rob00x@gmail.com

+
-

Interesting functions

- - - -
    -

  • overline() - Aggregate overlaying route lines and data intelligently

    • -

  • calc_catchment() - Create a 'catchment area' to show the areas serving a destination

    • -

  • route_cyclestreets() - Finds the fastest routes for cyclists between two places.

    • -
- -

See also

- -

https://github.com/ropensci/stplanr

-

Author

- -

Robin Lovelace rob00x@gmail.com

- -
- -
+
-
+ - - + + diff --git a/docs/reference/toptail_buff-1.png b/docs/reference/toptail_buff-1.png index 3305fc07a270e0b35fca0055410ca53282c8d292..f0dfe25005abb749ce06a144de906caf357b3c59 100644 GIT binary patch delta 31838 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 delta 31813 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 - - - - - - -Clip the beginning and ends SpatialLines to the edge of SpatialPolygon borders — toptail_buff • stplanr - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
-
+
+ +
+
-
-
-

Clip the beginning and ends SpatialLines to the edge of SpatialPolygon borders

- Source: R/toptail.R - +
+

Clip the beginning and ends of sf LINESTRING objects

+ Source: R/toptail.R +
toptail_buff.Rd
-
+

Takes lines and removes the start and end point, to a distance determined -by the nearest polygon border.

+by the nearest buff polygon border.

- 
toptail_buff(l, buff, ...)
- -

Arguments

- - - - - - - - - - - - - - -
l

An sf LINESTRING object

buff

An sf POLYGON object to act as the buffer

...

Arguments passed to rgeos::gBuffer()

- -

See also

+
+

Usage

+ 
toptail_buff(l, buff, ...)
+
-

Other lines: -angle_diff(), -geo_toptail(), -is_linepoint(), -line2df(), -line2points(), -line_bearing(), -line_breakup(), -line_match(), -line_midpoint(), -line_sample(), -line_segment(), -line_via(), -mats2line(), -n_sample_length(), -n_vertices(), -onewaygeo(), -points2line(), -toptailgs(), -update_line_geometry()

+
+

Arguments

+
l
+

An sf object representing lines

+ + +
buff
+

An sf object with POLYGON geometry to buffer the linestring.

+ + +
...
+

Arguments passed to sf::st_buffer()

+ +
+
+

See also

+

Other lines: +angle_diff(), +geo_toptail(), +is_linepoint(), +line2df(), +line2points(), +line_bearing(), +line_breakup(), +line_midpoint(), +line_segment(), +line_via(), +mats2line(), +n_vertices(), +onewaygeo(), +points2line()

+
-

Examples

- 
l <- routes_fast_sf
-buff <- zones_sf
-r_toptail <- toptail_buff(l, buff)
-
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
#> although coordinates are longitude/latitude, st_intersects assumes that they are planar
#> although coordinates are longitude/latitude, st_difference assumes that they are planar
nrow(l)
-
#> [1] 49
nrow(r_toptail)
-
#> [1] 8
plot(zones_sf$geometry)
-
plot(l$geometry, add = TRUE)
-
plot(r_toptail$geometry, lwd = 5, add = TRUE)
-
-
- -
+
+

Examples

+ 
l <- routes_fast_sf
+buff <- zones_sf
+r_toptail <- toptail_buff(l, buff)
+nrow(l)
+#> [1] 49
+nrow(r_toptail)
+#> [1] 8
+plot(zones_sf$geometry)
+plot(l$geometry, add = TRUE)
+plot(r_toptail$geometry, lwd = 5, add = TRUE)
+
+
+
+
-
+ - - + + diff --git a/man/cents_sf.Rd b/man/cents_sf.Rd index 24ff3edf..6739356f 100644 --- a/man/cents_sf.Rd +++ b/man/cents_sf.Rd @@ -35,6 +35,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/destinations_sf.Rd b/man/destinations_sf.Rd index dabd2f07..bd258bd7 100644 --- a/man/destinations_sf.Rd +++ b/man/destinations_sf.Rd @@ -26,6 +26,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/flow.Rd b/man/flow.Rd index bd435fc4..32109dd0 100644 --- a/man/flow.Rd +++ b/man/flow.Rd @@ -40,6 +40,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} @@ -55,6 +56,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/flow_dests.Rd b/man/flow_dests.Rd index 0c91c3d5..85faa4e9 100644 --- a/man/flow_dests.Rd +++ b/man/flow_dests.Rd @@ -36,6 +36,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/flowlines_sf.Rd b/man/flowlines_sf.Rd index fbacfec1..b68bf2c1 100644 --- a/man/flowlines_sf.Rd +++ b/man/flowlines_sf.Rd @@ -22,6 +22,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/line_cast.Rd b/man/line_cast.Rd new file mode 100644 index 00000000..8f54b6e2 --- /dev/null +++ b/man/line_cast.Rd @@ -0,0 +1,14 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/rnet_join.R +\name{line_cast} +\alias{line_cast} +\title{Convert multilinestring object into linestrings} +\usage{ +line_cast(x) +} +\arguments{ +\item{x}{Linestring object} +} +\description{ +Without losing vertices +} diff --git a/man/od_data_lines.Rd b/man/od_data_lines.Rd index 34051f67..657657c6 100644 --- a/man/od_data_lines.Rd +++ b/man/od_data_lines.Rd @@ -25,6 +25,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/od_data_routes.Rd b/man/od_data_routes.Rd index 20987925..d7a17c9f 100644 --- a/man/od_data_routes.Rd +++ b/man/od_data_routes.Rd @@ -27,6 +27,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/od_data_sample.Rd b/man/od_data_sample.Rd index 1c633e1b..8930e8d8 100644 --- a/man/od_data_sample.Rd +++ b/man/od_data_sample.Rd @@ -25,6 +25,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/osm_net_example.Rd b/man/osm_net_example.Rd index fa8e660a..3652e4b6 100644 --- a/man/osm_net_example.Rd +++ b/man/osm_net_example.Rd @@ -25,6 +25,7 @@ Other data: \code{\link{od_data_sample}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/read_table_builder.Rd b/man/read_table_builder.Rd index d7ab8ba8..35ae988f 100644 --- a/man/read_table_builder.Rd +++ b/man/read_table_builder.Rd @@ -52,6 +52,7 @@ Other data: \code{\link{od_data_sample}}, \code{\link{osm_net_example}}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/rnet_join.Rd b/man/rnet_join.Rd new file mode 100644 index 00000000..9010b26d --- /dev/null +++ b/man/rnet_join.Rd @@ -0,0 +1,95 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/rnet_join.R +\name{rnet_join} +\alias{rnet_join} +\title{Join route networks} +\usage{ +rnet_join( + rnet_x, + rnet_y, + dist = 5, + length_y = TRUE, + key_column = 1, + subset_x = TRUE, + dist_subset = 5, + split_y = TRUE, + ... +) +} +\arguments{ +\item{rnet_x}{Target route network, the output will have the same geometries +as features in this object.} + +\item{rnet_y}{Source route network. Columns from this route network object will +be copied across to the new network.} + +\item{dist}{The buffer width around rnet_y in meters. 1 m by default.} + +\item{length_y}{Add a new column called \code{length_y}? Useful when joining based on +length of segments (e.g. weighted mean). \code{TRUE} by default.} + +\item{key_column}{The index of the key (unique identifier) column in \code{rnet_x}.} + +\item{subset_x}{Subset the source route network by the target network before +creating buffers? This can lead to faster and better results. Default: +\code{TRUE}.} + +\item{dist_subset}{The buffer distance in m to apply when breaking up the +source object \code{rnet_y}. Default: 5.} + +\item{split_y}{Should the second route network be split at the start and +end points of LINESTRING features in the first? \code{TRUE} by default.} + +\item{...}{Additional arguments passed to \code{rnet_subset}.} +} +\description{ +This is a spatial join function that is enables adding columns to a +'target' route network from a 'source' route +network that contains the base geometry, e.g. from OSM +} +\details{ +The output is an sf object containing polygons representing +buffers around the route network in \code{rnet_x}. +The examples below demonstrate how to join attributes from +a route network object created with the function \code{\link[=overline]{overline()}} onto +OSM geometries. + +Note: The main purpose of this function is to join an ID from \code{rnet_x} +onto \code{rnet_y}. Subsequent steps, e.g. with \code{\link[dplyr:mutate-joins]{dplyr::inner_join()}} +are needed to join the attributes back onto \code{rnet_x}. +There are rarely 1-to-1 relationships between spatial network geometries +so we take care when using this function. + +See \href{https://github.com/ropensci/stplanr/issues/505}{#505} for details +and a link to an interactive example of inputs and outputs shown below. +} +\examples{ +library(sf) +library(dplyr) +# Uncomment for interactive examples: +plot(route_network_small["flow"]) +plot(osm_net_example$geometry, lwd = 5, col = "grey") +plot(route_network_small["flow"], add = TRUE) +rnetj = rnet_join(osm_net_example, route_network_small, dist = 9) +# library(mapview) +# mapview(rnetj, zcol = "flow") + +# mapview(route_network_small, zcol = "flow") +plot(rnetj["flow"]) +plot(route_network_small["flow"], add = TRUE) +rnetj_summary = rnetj \%>\% + sf::st_drop_geometry() \%>\% + group_by(osm_id) \%>\% + summarise( + flow = weighted.mean(flow, length_y, na.rm = TRUE), + ) +osm_joined_rnet = left_join(osm_net_example, rnetj_summary) +plot(route_network_small["flow"]) +plot(osm_joined_rnet[c("flow")]) +# Improve fit between geometries and performance by subsetting rnet_x +osm_subset = rnet_subset(osm_net_example, route_network_small, dist = 5) +osm_joined_rnet = left_join(osm_subset, rnetj_summary) +plot(route_network_small["flow"]) +plot(osm_joined_rnet[c("flow")]) +# mapview(joined_network) + +# mapview(route_network_small) +} diff --git a/man/rnet_split_lines.Rd b/man/rnet_split_lines.Rd new file mode 100644 index 00000000..f137de57 --- /dev/null +++ b/man/rnet_split_lines.Rd @@ -0,0 +1,20 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/rnet_join.R +\name{rnet_split_lines} +\alias{rnet_split_lines} +\title{Split lines in a route network based points} +\usage{ +rnet_split_lines(rnet_x, geo_y, dist = 1) +} +\arguments{ +\item{rnet_x}{The route network to be broken into smaller pieces} + +\item{geo_y}{The geographic object used to break up the route network} + +\item{dist}{The width of the buffer used when breaking up the route network. +For imprecise data it may be worth increasing this above 1 m, the default.} +} +\description{ +If the object passed to the second argument has LINSTRING geometries +the start and end points of linestrings are used. +} diff --git a/man/rnet_subset.Rd b/man/rnet_subset.Rd new file mode 100644 index 00000000..87ad093c --- /dev/null +++ b/man/rnet_subset.Rd @@ -0,0 +1,24 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/rnet_join.R +\name{rnet_subset} +\alias{rnet_subset} +\title{Subset one route network based on overlaps with another} +\usage{ +rnet_subset(rnet_x, rnet_y, dist = 1, crop = TRUE, min_x = 3) +} +\arguments{ +\item{rnet_x}{The route network to be subset} + +\item{rnet_y}{The subsetting route network} + +\item{dist}{The buffer width around y in meters. 1 m by default.} + +\item{crop}{Crop \code{rnet_x}? \code{TRUE} is the default} + +\item{min_x}{Segments shorter than this multiple of dist +\emph{and} which were longer +before the cropping process will be removed. 3 by default.} +} +\description{ +Subset one route network based on overlaps with another +} diff --git a/man/route_network_sf.Rd b/man/route_network_sf.Rd index 78cc3d75..f9255968 100644 --- a/man/route_network_sf.Rd +++ b/man/route_network_sf.Rd @@ -3,7 +3,7 @@ \docType{data} \name{route_network_sf} \alias{route_network_sf} -\title{spatial lines dataset representing a route network} +\title{Spatial lines dataset representing a route network} \format{ A spatial lines dataset 80 rows and 1 column } @@ -23,6 +23,7 @@ Other data: \code{\link{od_data_sample}}, \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} diff --git a/man/route_network_small.Rd b/man/route_network_small.Rd new file mode 100644 index 00000000..3b6ab221 --- /dev/null +++ b/man/route_network_small.Rd @@ -0,0 +1,32 @@ +% Generated by roxygen2: do not edit by hand +% Please edit documentation in R/data.R +\docType{data} +\name{route_network_small} +\alias{route_network_small} +\title{Spatial lines dataset representing a small route network} +\format{ +A spatial lines dataset with one column: flow +} +\description{ +The flow between randomly selected vertices on the \code{osm_net_example}. +See \code{data-raw/route_network_small.R} for details. +} +\seealso{ +Other data: +\code{\link{cents_sf}}, +\code{\link{destinations_sf}}, +\code{\link{flow_dests}}, +\code{\link{flowlines_sf}}, +\code{\link{flow}}, +\code{\link{od_data_lines}}, +\code{\link{od_data_routes}}, +\code{\link{od_data_sample}}, +\code{\link{osm_net_example}}, +\code{\link{read_table_builder}()}, +\code{\link{route_network_sf}}, +\code{\link{routes_fast_sf}}, +\code{\link{routes_slow_sf}}, +\code{\link{zones_sf}} +} +\concept{data} +\keyword{datasets} diff --git a/man/routes_fast_sf.Rd b/man/routes_fast_sf.Rd index de48d341..eb54535f 100644 --- a/man/routes_fast_sf.Rd +++ b/man/routes_fast_sf.Rd @@ -28,6 +28,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_slow_sf}}, \code{\link{zones_sf}} } diff --git a/man/routes_slow_sf.Rd b/man/routes_slow_sf.Rd index f6ac3d1a..baa1d223 100644 --- a/man/routes_slow_sf.Rd +++ b/man/routes_slow_sf.Rd @@ -24,6 +24,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{zones_sf}} } diff --git a/man/zones_sf.Rd b/man/zones_sf.Rd index 9e3d949d..83f1ae77 100644 --- a/man/zones_sf.Rd +++ b/man/zones_sf.Rd @@ -30,6 +30,7 @@ Other data: \code{\link{osm_net_example}}, \code{\link{read_table_builder}()}, \code{\link{route_network_sf}}, +\code{\link{route_network_small}}, \code{\link{routes_fast_sf}}, \code{\link{routes_slow_sf}} }