zb_segment

Functions, documentation and example data to help divide
geographic space into discrete polygons (zones).
The package supports new zoning systems that are documented in the
accompanying paper,
"ClockBoard: A zoning system for urban analysis",
by Lovelace et al. (2022) <doi:10.5311/JOSIS.2022.24.172>.
The functions are motivated by research into the merits of different zoning systems
(Openshaw, 1977) <doi:10.1068/a090169>. A flexible ClockBoard zoning system is
provided, which breaks-up space by concentric rings
and radial lines emanating from a central point.
By default, the diameter of the rings grow according to the triangular number sequence
(Ross & Knott, 2019) <doi:10.1080/26375451.2019.1598687> with the first 4 doughnuts
(or annuli) measuring 1, 3, 6, and 10 km wide.
These annuli are subdivided into equal segments (12 by default), creating the
visual impression of a dartboard. Zones are labelled according to
distance to the centre and angular distance from North, creating a simple
geographic zoning and labelling system useful for visualising geographic
phenomena with a clearly demarcated central location such as cities.

Robin Lovelace

zonebuilder

Create and Explore Geographic Zoning Systems

Martijn Tennekes

zb_segment function

<dl><dt>x</dt>
<dd>Centre point. Should be an <code><a href="https://r-spatial.github.io/sf/reference/sf.html">sf</a></code> or <code><a href="https://r-spatial.github.io/sf/reference/sfc.html">sfc</a></code> object containing one point, or a name of a city (which is looked up with OSM geocoding).</dd>
<dt>area</dt>
<dd>(optional) Area. Should be an <code><a href="https://r-spatial.github.io/sf/reference/sf.html">sf</a></code> or <code><a href="https://r-spatial.github.io/sf/reference/sfc.html">sfc</a></code> object containing one (multi) polygon</dd>
<dt>n_segments</dt>
<dd>(optional) Number of segments. The number of segments. Either one number which determines the number of segments applied to all circles, or a vector with a number for each circle (which should be a multiple of 4, see also the argument <code>labeling</code>). By default, the central circle is not segmented (see the argument <code>segment_center</code>).</dd>
<dt>distance</dt>
<dd>Distance The distances between the circles. For the center circle, it is the distance between the center and the circle. If only one number is specified, <code>distance_growth</code> determines the increment at which the distances grow for the outer circles.</dd></dl>

Arguments

Make segments — zb_segment

<dl>

<dt>x</dt>
<dd>Centre point. Should be an <code><a href='https://r-spatial.github.io/sf/reference/sf.html'>sf</a></code> or <code><a href='https://r-spatial.github.io/sf/reference/sfc.html'>sfc</a></code> object containing one point, or a name of a city (which is looked up with OSM geocoding).</dd>


<dt>area</dt>
<dd>(optional) Area. Should be an <code><a href='https://r-spatial.github.io/sf/reference/sf.html'>sf</a></code> or <code><a href='https://r-spatial.github.io/sf/reference/sfc.html'>sfc</a></code> object containing one (multi) polygon</dd>


<dt>n_segments</dt>
<dd>(optional) Number of segments. The number of segments. Either one number which determines the number of segments applied to all circles, or a vector with a number for each circle (which should be a multiple of 4, see also the argument <code>labeling</code>). By default, the central circle is not segmented (see the argument <code>segment_center</code>).</dd>


<dt>distance</dt>
<dd>Distance The distances between the circles. For the center circle, it is the distance between the center and the circle. If only one number is specified, <code>distance_growth</code> determines the increment at which the distances grow for the outer circles.</dd>

</dl>

zb_segment: Make segments

Description

Usage

Value

Arguments

Examples