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

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

- area (required)

- label (required)

- subgroup, subgroup2 or subgroup3

- colour

- size

- alpha

- family

- fontface

- angle

### 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]