geomLabelRepel

constructor(data: Map<*, *>? = null, stat: StatOptions = Stat.identity, position: PosOptions = positionIdentity, showLegend: Boolean = true, inheritAes: Boolean? = null, manualKey: Any? = null, sampling: SamplingOptions? = null, tooltips: TooltipOptions? = null, map: SpatialDataset? = null, mapJoin: <Error class: unknown class><Any, Any>? = null, useCRS: String? = null, x: Number? = null, y: Number? = null, label: String? = null, alpha: Number? = null, color: Any? = null, fill: Any? = null, size: Number? = null, family: String? = null, fontface: String? = null, hjust: Any? = null, vjust: Any? = null, angle: Number? = null, shape: Any? = null, pointSize: Any? = null, pointStroke: Any? = null, segmentColor: Any? = null, segmentSize: Any? = null, segmentAlpha: Any? = null, linetype: Any? = null, lineheight: Number? = null, labelFormat: String? = null, naText: String? = null, nudgeX: Number? = null, nudgeY: Number? = null, nudgeUnit: String? = null, labelPadding: Number? = null, labelR: Number? = null, labelSize: Number? = null, alphaStroke: Boolean? = null, sizeUnit: String? = null, colorBy: String? = null, fillBy: String? = null, checkOverlap: Boolean? = null, seed: Int? = null, maxIter: Int? = null, maxTime: Double? = null, direction: String? = null, pointPadding: Float? = null, boxPadding: Float? = null, maxOverlaps: Int? = null, minSegmentLength: Float? = null, arrow: Map<String, Any>? = null, mapping: LabelRepelMapping.() -> Unit = {})

Parameters

data

The data to be displayed in this layer. If null, the default, the data is inherited from the plot data as specified in the call to letsPlot.

stat

The statistical transformation to use on the data for this layer. Supported transformations: Stat.identity, Stat.bin(), Stat.count(), etc. see Stat.

position

Position adjustment: positionIdentity, positionStack(), positionDodge(), etc. see Position.

showLegend

default = true. false - do not show legend for this layer.

inheritAes

default = true. false - do not combine the layer aesthetic mappings with the plot shared mappings.

manualKey

String or result of the call to the layerKey() function. The key to show in the manual legend. Specifies the text for the legend label or advanced settings using the layerKey() function.

sampling

Result of the call to the samplingXxx() function. To prevent any sampling for this layer pass value samplingNone. For more info see sampling.html.

tooltips

Result of the call to the layerTooltips() function. Specifies appearance, style and content. Set tooltips = tooltipsNone to hide tooltips from the layer.

map

Data-structure containing series of planar shapes and, optionally, associated data series (for example: names of States and their boundaries).

Supported shapes: Point and MultiPoint. All coordinates should be encoded as decimal degrees in WGS84 coordinate reference system.

Can be used with parameter mapJoin for joining data and map coordinates.

mapJoin

Pair of Names or Pair of Lists of Names. Specifies column names to join the data and the map coordinates on.

  • Pair.first: column name or list of column names in the data dataframe.

  • Pair.second: column name or list of column names in the map dataframe.

useCRS

By default, all coordinates are converted into degrees of longitude and latitude, and these map coordinates are projected onto the screen coordinates using Mercator projection. Specify useCRS = "provided" to keep the SpatialDataset's original coordinate reference system (CRS).

x

X-axis value.

y

Y-axis value.

label

Text to add to plot.

alpha

Transparency level of a layer. Understands numbers between 0 and 1.

color

Color of the geometry. For more info see: aesthetics.html#color-and-fill.

fill

Background color of the label. For more info see: aesthetics.html#color-and-fill.

size

Font size.

family

default = "sans". For more info see: aesthetics.html#font-family.

fontface

default = "plain". For more info see: aesthetics.html#font-face.

hjust

horizontal text alignment relative to the x-coordinate. Possible values: 0 or "left" - left-aligned (text starts at x), 0.5 or "middle" (default) - text is centered on x, 1 or "right" - right-aligned (text ends at x). There are two special alignments: "inward" (aligns text towards the plot center) and "outward" (away from the plot center).

vjust

vertical text alignment relative to the y-coordinate. Possible values: 0 or "bottom" - bottom-aligned (bottom of text at y), 0.5 or "center" (default) - middle of text at y, 1 or "top" - top-aligned (top of text at y). There are two special alignments: "inward" (aligns text towards the plot center) and "outward" (away from the plot center).

angle

Label rotation angle in degrees.

lineheight

Line height multiplier applied to the font size in the case of multi-line text.

labelFormat

Specifies the format pattern for displaying mapped values.

naText

default = "n/a". Text to show for missing values.

nudgeX

Horizontal adjustment to nudge labels by.

nudgeY

Vertical adjustment to nudge labels by.

labelPadding

default = 0.25. Amount of padding around label, measured in units of font size.

labelR

default = 0.15. Radius of rounded corners, measured in units of label height.

labelSize

default = 1.0. Size of label border.

alphaStroke

default = false. Enables the applying of 'alpha' to 'color' (label text and border).

sizeUnit

("x", "y", "min", "max"). Relate the size of the text label to the length of the unit step along one of the axes. "x" uses the unit step along the x-axis, "y" uses the unit step along the y-axis. "min" uses the smaller of the unit steps along the x- and y-axes. "max" uses the larger of the unit steps along the x- and y-axes. If not specified, no fitting is performed.

nudgeUnit

("identity", "size", "px") Units for x and y nudging. Possible values:

  • "identity": a unit of 1 corresponds to a difference of 1 in data space;

  • "size": a unit of 1 corresponds to the diameter of a point with size=1;

  • "px": the unit is measured in screen pixels.

colorBy

default = "color" ("fill", "color", "paint_a", "paint_b", "paint_c"). Defines the color aesthetic for the geometry.

fillBy

default = "fill" ("fill", "color", "paint_a", "paint_b", "paint_c"). Defines the fill aesthetic for the geometry.

checkOverlap

Skips plotting text that overlaps previous text in the same layer.

seed

Random seed for reproducibility.

maxIter

default = 2000. Maximum number of iterations used to resolve collisions.

maxTime

default = 5. Maximum allowed time in seconds for resolving label collisions.

direction

default = "both" ("both", "x", "y"). Direction in which text labels can be moved.

pointPadding

Padding around data points to prevent overlap with text labels.

boxPadding

Padding around text labels to prevent overlap between labels.

maxOverlaps

default = 10. The maximum number of overlapping text labels allowed. Additional text labels will be hidden.

minSegmentLength

Minimum length of the line connecting the label to the point. Shorter segments will be omitted.

arrow

Specification for arrow head, as created by arrow() function.

mapping

Set of aesthetic mappings. Aesthetic mappings describe the way that variables in the data are mapped to plot "aesthetics".

Format patterns in the labelFormat parameter can be just a number format (like "d") or a string template where number format is surrounded by curly braces: "{d} cylinders". For more info see: formats.html Note: the "$" must be escaped as "\$".

Examples:

  • ".2f" -> "12.45"

  • "Score: {.2f}" -> "Score: 12.45"

  • "Score: {}" -> "Score: 12.454789"