Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zonebuilders/zonebuilder
Divide geographic space into discrete chunks
https://github.com/zonebuilders/zonebuilder
Last synced: 3 months ago
JSON representation
Divide geographic space into discrete chunks
- Host: GitHub
- URL: https://github.com/zonebuilders/zonebuilder
- Owner: zonebuilders
- License: gpl-3.0
- Created: 2019-12-11T00:23:39.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-02-12T08:36:13.000Z (over 2 years ago)
- Last Synced: 2024-03-20T17:09:25.377Z (3 months ago)
- Language: R
- Homepage: https://zonebuilders.github.io/zonebuilder/
- Size: 43.1 MB
- Stars: 33
- Watchers: 5
- Forks: 2
- Open Issues: 13
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE.md
Lists
- awesome-r-dataviz - zonebuilder - Divide geographic space into discrete chunks. (Spatial Visualization / Miscellaneous)
- awesome-stars - zonebuilders/zonebuilder - Divide geographic space into discrete chunks (R)
- jimsghstars - zonebuilders/zonebuilder - Divide geographic space into discrete chunks (R)
README
---
output: github_document
editor_options:
chunk_output_type: console
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# zonebuilder
[](https://github.com/zonebuilders/zonebuilder/actions)
[](https://CRAN.R-project.org/package=zonebuilder)
[](https://www.r-pkg.org/pkg/zonebuilder)
[DOI](https://doi.org/10.31219/osf.io/vncgw)
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](https://zonebuilders.github.io/zonebuilder/).
## Installation
You can install the released version of zonebuilder from [CRAN](https://CRAN.R-project.org) with:
```{r, eval=FALSE}
install.packages("zonebuilder")
```
Install it from [GitHub](https://github.com/) with:
```{r install-gh, eval=FALSE}
# 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:
```{r}
library(zonebuilder)
library(tmap)
tm_shape(london_a()) + tm_borders() + tm_shape(london_c()) + tm_dots("red")
```
The main function `zb_zone` breaks this geographical scale into zones. The default settings follow the **ClockBoard** configuration:
```{r}
london_zones <- zb_zone(london_c(), london_a())
zb_plot(london_zones)
```
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:
```{r fig.height=3}
par(mfrow = c(1, 3))
zb_plot(zb_doughnut(london_c(), london_a(), n_circles = 5), title = "Doughnuts")
zb_plot(zb_segment(london_c(), n_segments = 20), title = "Segments")
zb_plot(zb_zone(london_c(), n_circles = 4, n_segments = 4), title = "4 segments, 4 circles")
```
The package also contains a function to create zones based on a simple rectangular grid system:
```{r}
z = zb_quadrat(london_a(), ncol = 10)
plot(z)
```
## Contribute
Contributions are welcome!
It may be worth checking-in in a [discussion post](https://github.com/zonebuilders/zonebuilder/discussions/28) before opening an issue.
## Citation
Watch this space.