layerLabels

Configure annotations for geometry layers.

Annotations are currently supported for bar, pie, and crossbar geometry layers. This class provides methods to customize the appearance and content of text labels displayed on these geometries.

Notes

By default, annotation text color is automatically selected for optimal contrast: white text appears on darker filled geometries, and black text appears on lighter filled geometries.

Use theme(labelText = elementText(color = ...)) to customize the appearance of annotation text. See also elementText().

Alternatively, the inheritColor() method can be used to make annotation text use the geometry's color aesthetic, overriding both the automatically selected text color and any color specified via theme(labelText = elementText(color = ...)).

Examples

• annotations_for_pie.ipynb

val data = mapOf("name" to listOf("a", "b", "c", "d", "b"), "value" to listOf(40, 90, 10, 50, 20))
letsPlot(data) +
     geomPie(
         size = 15, hole = 0.2,
         labels = layerLabels("..proppct..").format("..proppct..", "{.1f}%").size(15)
     ) { fill = asDiscrete("name", orderBy = "..count.."); weight = "value" }

Parameters