Skip to contents

Draws the hierarchy as an icicle: one row per geoframe, coarsest at the top, each region's width proportional to its share of the weight.

Usage

geoscale_autoplot(
  x,
  type = c("icicle", "stack"),
  weight = NULL,
  fill = c("geoframe", "region"),
  label = TRUE,
  view = NULL,
  angle = NULL,
  ratio = NULL,
  shear = 0.45,
  depth = 0.55,
  gap = NULL,
  rotate = 0,
  direction = c("up", "down"),
  precision = 0,
  data = NULL,
  z = NULL,
  rule = "weighted_mean",
  labels = NULL,
  palette = "H",
  colour = "grey35",
  linewidth = 0.2,
  frame = NULL,
  frame_fill = NA,
  connectors = FALSE,
  outline = NULL,
  outline_colour = "grey20",
  outline_linewidth = 0.6,
  ...
)

# S3 method for class 'GeoScale'
autoplot(x, ...)

Arguments

x

A GeoScale.

type

"icicle" (default) or "stack" — the axonometric stacked-maps view: one sheared map plane per geoframe, coarsest on top, the same atoms dissolved at each resolution. Requires attached geometry (and the sf package); weight/fill/label apply to the icicle only.

weight

Weight column determining widths. NULL uses the default.

fill

What to colour by: "geoframe" or "region".

label

Draw region codes on the rectangles.

view

type = "stack" only: a predefined point of view – "oblique" (the shear/depth default), "top-down", "cavalier", "cabinet", "military", "isometric", "dimetric", "trimetric", "perspective" (receding planes shrink) or "pyramid" (receding planes grow: the coarsest geoframe is the small top, the finest the wide base).

angle, ratio

type = "stack" only: oblique view by angle (degrees of the receding axis) and foreshortening ratio – e2 = ratio * (cos(angle), sin(angle)). Overridden by view.

shear, depth, gap

type = "stack" only: raw receding-axis components (e2 = (shear, depth); used when neither view nor angle/ratio is given) and the vertical spacing between planes: one value for every pair, or one per pair from the top down. gap = NULL (default) spaces planes almost touching, with a slight overlap. Under "perspective" and "pyramid" each spacing is scaled with the planes it separates, so it stays uniform relative to their size.

rotate

type = "stack" only: in-plane rotation of each plane (degrees, counter-clockwise).

direction

type = "stack" only: "up" (default) stacks the coarsest geoframe on top; "down" puts it at the bottom.

precision

type = "stack" only: GEOS precision for the dissolve, forwarded to geoscale_geometry(). Default 0 = off.

data, z

Colour the figure by a value instead of by structure: works for BOTH types – the icicle fills each band's rectangles (overriding fill), the stack fills each plane. data must carry the atom geoframe as a key column plus the value column named by z; every coarser geoframe gets the value recast up with recast_geoscale() (see rule), so the whole figure shares one continuous fill scale (legend title via labs(fill = )).

rule

With data: aggregation rule used to recast z from the atoms to each coarser geoframe ("weighted_mean" default; see recast_geoscale()). The icicle weight argument doubles as the weight column for "weighted_mean" (NULL = the geoscale's default weight). "share" colours every plane by each region's share within the plane above it (the coarsest plane by its share of the grand total), so the whole figure reads on one 0..1 scale; weight plays no part.

labels

type = "stack" only: character vector of geoframes whose regions get their display names (the @meta$labels column, falling back to codes) drawn on the plane. NULL (default) = none.

palette

Viridis palette option ("A".."H") for the plane fill and for both types' data fills. Default "H". NULL adds no fill scale at all, so a custom scale can be supplied – e.g. energypal::scale_fill_energy_b() for the Global Wind Atlas colours on their absolute breaks. With rule = "share" the fill is a fixed linear 0..1 scale, with "logshare" a fixed log10 percent scale (0.01%..100%) – either way any two share figures are colour-comparable.

colour, linewidth

type = "stack" only: region border colour and width, recycled across the planes (so colour = c("white", "grey40", "white") styles one plane per entry). Defaults "grey35" and 0.2 – ggplot2's own sf polygon border.

frame

type = "stack" only: draw each plane's outline (the footprint box run through the same projection) as a guide – curved shapes are much easier to read in oblique views with the plane edges visible. TRUE uses "grey80", a colour string uses that colour, NULL (default) draws no frames.

frame_fill

type = "stack" only: fill for the plane sheets. Best mostly transparent, e.g. frame_fill = ggplot2::alpha("grey60", 0.12) – the panes then read as glass sheets and slightly dim what lies beneath them. Setting a fill draws the frames even without frame; NA (default) = no fill.

connectors

type = "stack" only: draw dashed lines joining the corresponding frame corners of adjacent planes – the vertical guides of the stack. TRUE uses the frame colour, a colour string picks its own; default FALSE.

outline

type = "stack" only: coarser geoframe(s) whose borders are drawn over every finer plane, so the groups they form are visible at the finer resolution (outline = "zone" marks the zones on the region plane). NULL (default) = none.

outline_colour, outline_linewidth

type = "stack" only: colour and width of the outline borders, recycled over outline. Defaults "grey20" and 0.6.

...

Unused.

Value

A ggplot object.

Details

This is the structure plot — it shows the GeoScale itself and needs no geometry. For a map of values over regions, see geoscale_plot().

Also registered as an autoplot() method, so ggplot2::autoplot(gs) works when ggplot2 is installed.

Examples

if (requireNamespace("ggplot2", quietly = TRUE)) {
  geoscale_autoplot(geoscale_example())
}