geom_treemap_text {treemapify}R Documentation

A 'ggplot2' geom to add text labels to treemap tiles.

Description

'geom_treemap_text' can be used to add a text label to each tile in a treemap created with 'geom_treemap'.

Usage

geom_treemap_text(mapping = NULL, data = NULL, stat = "identity",
  position = "identity", na.rm = FALSE, show.legend = FALSE,
  inherit.aes = TRUE, padding.x = grid::unit(1, "mm"),
  padding.y = grid::unit(1, "mm"), place = "topleft", min.size = 4,
  grow = FALSE, reflow = FALSE, fixed = FALSE, ...)

Arguments

mapping, data, stat, position, na.rm, show.legend, inherit.aes, ...

Standard geom arguments as for 'ggplot2::geom_text'.

padding.x, padding.y

'grid::unit' object, giving horizontal or vertical padding between text and edge of tile. Defaults to 1 mm.

place

Where inside the box to place the text. Default is 'bottom'; other options are 'topleft', 'top', 'topright', etc.

min.size

Minimum font size, in points. If provided, text that would need to be shrunk below this size to fit the box will not be drawn. Defaults to 4 pt.

grow

If 'TRUE', text will be grown as well as shrunk to fill the box.

reflow

If 'TRUE', text will be reflowed (wrapped) to better fit the box.

fixed

If ‘TRUE', the alternative ’fixed' tile layout algorithm will be used.

Details

'geom_treemap_text' requires 'area' and 'label' aesthetics. Several other standard 'ggplot2' aesthetics are supported (see Aesthetics).

‘geom_treemap_text' uses the ’ggfittext' package to fit text to tiles. All text drawing options available in 'ggfittext::geom_fit_text' (growing, reflowing, etc.) are also available here. For full details on how these options work, see the documentation for 'ggfittext::geom_fit_text'.

All 'treemapify' geoms added to a plot should have the same value for 'fixed', or they will not share a common layout (see 'geom_treemap' for details on the layout algorithms).

Aesthetics

See Also

geom_treemap

Examples


ggplot2::ggplot(G20, ggplot2::aes(area = gdp_mil_usd,
                                  fill = econ_classification,
                                  label = country)) +
  geom_treemap() +
  geom_treemap_text()


[Package treemapify version 2.5.0 Index]