Awesome
<!-- README.md is generated from README.Rmd. Please edit that file -->zonebuilder
<!-- badges: start --> <!-- [![Codecov test coverage](https://codecov.io/gh/zonebuilders/zonebuilder/branch/master/graph/badge.svg)](https://codecov.io/gh/zonebuilders/zonebuilder?branch=master) -->DOI <!-- badges: end -->
The goal of zonebuilder is to break up large geographic regions such as cities into manageable zones. Zoning systems are important in many fields, including demographics, economy, health, and transport. The zones have standard configuration, which enabled comparability across cities. See its website at zonebuilders.github.io/zonebuilder.
Installation
You can install the released version of zonebuilder from CRAN with:
install.packages("zonebuilder")
Install it from GitHub with:
# install.packages("remotes")
remotes::install_github("zonebuilders/zonebuilder")
Using zonebuilder
Zonebuilder builds on the sf
package and works well with mapping
packages such as ggplot2
, leaflet
, mapdeck
, mapview
and tmap
,
the last of which we’ll use in the following maps. Attaching the package
provides the example datasets london_a()
and london_c()
, the
geographic boundary and the centre of London:
library(zonebuilder)
library(tmap)
tm_shape(london_a()) + tm_borders() + tm_shape(london_c()) + tm_dots("red")
<img src="man/figures/README-unnamed-chunk-3-1.png" width="100%" />
The main function zb_zone
breaks this geographical scale into zones.
The default settings follow the ClockBoard configuration:
london_zones <- zb_zone(london_c(), london_a())
zb_plot(london_zones)
<img src="man/figures/README-unnamed-chunk-4-1.png" width="100%" />
The idea behind this zoning system is based on the following principles:
- Most cities have a centre, the ‘heart’ of the city. Therefore, the zones are distributed around the centre.
- Typically, the population is much denser in and around the centre and also the traffic intensity is higher. Therefore, the zones are smaller in and around the centre.
- The rings (so A, B, C, D, etc) reflect the proximity to the centre point. The distances from the outer borders of the rings A, B, C, D, etc. follow the triangular number sequence 1, 3, 6, 10, etc. This means that in everyday life use, within zone A everything is in walking distance, from ring B to the centre requires a bike, from zone C and further to the centre typically requires public transport.
- Regarding direction relative to the centre, we use the clock analogy, since most people are familiar with that. So each ring (annuli) is divided into 12 segments, where segment 12 is directed at 12:00, segment 1 at 1:00 etc.
The package zonebuilder
does not only create zoning systems based on
the CloadBoard layout as illustrated below.
The function zb_zone
makes use of zb_doughnut
and zb_segment
,
which can also be used directly:
par(mfrow = c(1, 3))
zb_plot(zb_doughnut(london_c(), london_a(), n_circles = 5), title = "Doughnuts")
<img src="man/figures/README-unnamed-chunk-5-1.png" width="100%" />
zb_plot(zb_segment(london_c(), n_segments = 20), title = "Segments")
<img src="man/figures/README-unnamed-chunk-5-2.png" width="100%" />
zb_plot(zb_zone(london_c(), n_circles = 4, n_segments = 4), title = "4 segments, 4 circles")
<img src="man/figures/README-unnamed-chunk-5-3.png" width="100%" />
The package also contains a function to create zones based on a simple rectangular grid system:
z = zb_quadrat(london_a(), ncol = 10)
plot(z)
<img src="man/figures/README-unnamed-chunk-6-1.png" width="100%" />
Contribute
Contributions are welcome!
It may be worth checking-in in a discussion post before opening an issue.
Citation
Watch this space.
<!-- tmap_arrange( --> <!-- zb_view(zb_doughnut(london_c(), london_a(), n_circles = 5), title = "Doughnuts"), --> <!-- zb_view(zb_segment(london_c(), n_segments = 20), title = "Segments") --> <!-- ) -->