geomSina

class geomSina(val data: Map<*, *>? = null, val stat: StatOptions = Stat.sina(), val position: PosOptions = positionDodge(), val showLegend: Boolean = true, val inheritAes: Boolean? = null, val manualKey: Any? = null, val sampling: SamplingOptions? = null, val tooltips: TooltipOptions? = null, val orientation: String? = null, val x: Number? = null, val y: Number? = null, val violinWidth: Number? = null, val alpha: Number? = null, val color: Any? = null, val fill: Any? = null, val shape: Any? = null, val size: Number? = null, val stroke: Any? = null, val width: Number? = null, val weight: Number? = null, val scale: String? = null, val tailsCutoff: Number? = null, val bw: Any? = null, val kernel: String? = null, val n: Int? = null, val trim: Boolean? = null, val adjust: Number? = null, val fullScanMax: Int? = null, val quantiles: List<Number>? = null, val showHalf: Number? = null, val seed: Int? = null, val colorBy: String? = null, val fillBy: String? = null, mapping: SinaMapping.() -> Unit = {}) : Layer, SinaAesthetics, SinaParameters, SinaStatAesthetics, SinaStatParameters, WithColorOption, WithFillOption

A sina plot visualizes a single variable across classes, with jitter width reflecting the data density in each class.

Notes

Computed variables:

  • ..violinwidth.. : density scaled for the sina plot, according to area, counts or to a constant maximum width (mapped by default).

  • ..density.. : density estimate.

  • ..count.. : density * number of points.

  • ..scaled.. : density estimate, scaled to maximum of 1.

  • ..quantile.. : quantile estimate.

To hide axis tooltips, set "blank" or the result of elementBlank() to the axisTooltip, axisTooltipX or axisTooltipY parameter of the theme().

Examples

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

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

position

default = positionDodge(). 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.

orientation

Specifies the axis that the layer's stat and geom should run along. The default value (null) automatically determines the orientation based on the aesthetic mapping. If the automatic detection doesn't work, it can be set explicitly by specifying the "x" or "y" orientation.

x

X-axis coordinates.

y

Y-axis coordinates.

violinWidth

Density scaled for the sina plot, according to area, counts or to a constant maximum width.

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

Fill color. For more info see: aesthetics.html#color-and-fill.

shape

Shape of the sina points. For more info see: aesthetics.html#point-shapes.

size

Lines width. Defines line width.

stroke

Width of the shape border. Applied only to the shapes having border.

width

Width of sina bounding box.

weight

Used by Stat.sina() stat to compute weighted density.

seed

A random seed to make the jitter reproducible. If null (the default value), the seed is initialised with a random value.

showHalf

default = 0.

  • If -1, only half of each group is drawn.

  • If 1, another half is drawn.

  • If 0, sina look as usual.

quantiles

Draw horizontal lines at the given quantiles of the density estimate.

scale

default = "area".

  • If "area", all groups have the same area.

  • If "count", areas are scaled proportionally to the number of observations.

  • If "width", all groups have the same maximum width.

trim

default = true. Trim the tails of the violins, which limit the area for sina points, to the range of the data.

tailsCutoff

default = 3.0. Extend domain of each violin, which limit the area for sina points, on tailsCutoff * bw if trim = false.

kernel

The kernel we use to calculate the density function. Choose among "gaussian", "cosine", "optcosine", "rectangular" (or "uniform"), "triangular", "biweight" (or "quartic"), "epanechikov" (or "parabolic").

bw

String or Double. The method (or exact value) of bandwidth. Either a string (choose among "nrd0" and "nrd") or a double.

adjust

Adjusts the value of bandwidth by multiplying it. Changes how smooth the frequency curve is.

n

The number of sampled points for plotting the function.

fullScanMax

Maximum size of data to use density computation with "full scan". For bigger data, less accurate but more efficient density computation is applied.

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.

mapping

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

Constructors

Link copied to clipboard
constructor(data: Map<*, *>? = null, stat: StatOptions = Stat.sina(), position: PosOptions = positionDodge(), showLegend: Boolean = true, inheritAes: Boolean? = null, manualKey: Any? = null, sampling: SamplingOptions? = null, tooltips: TooltipOptions? = null, orientation: String? = null, x: Number? = null, y: Number? = null, violinWidth: Number? = null, alpha: Number? = null, color: Any? = null, fill: Any? = null, shape: Any? = null, size: Number? = null, stroke: Any? = null, width: Number? = null, weight: Number? = null, scale: String? = null, tailsCutoff: Number? = null, bw: Any? = null, kernel: String? = null, n: Int? = null, trim: Boolean? = null, adjust: Number? = null, fullScanMax: Int? = null, quantiles: List<Number>? = null, showHalf: Number? = null, seed: Int? = null, colorBy: String? = null, fillBy: String? = null, mapping: SinaMapping.() -> Unit = {})

Properties

Link copied to clipboard
open override val adjust: Number? = null
Link copied to clipboard
open override val alpha: Number? = null
Link copied to clipboard
open override val bw: Any? = null
Link copied to clipboard
open override val color: Any? = null
Link copied to clipboard
open override val colorBy: String? = null
Link copied to clipboard
val data: Map<*, *>? = null
Link copied to clipboard
open override val fill: Any? = null
Link copied to clipboard
open override val fillBy: String? = null
Link copied to clipboard
open override val fullScanMax: Int? = null
Link copied to clipboard
val geom: GeomOptions
Link copied to clipboard
Link copied to clipboard
open override val kernel: String? = null
Link copied to clipboard
val labels: layerLabels? = null
Link copied to clipboard
val manualKey: Any? = null
Link copied to clipboard
val mapping: <Error class: unknown class>
Link copied to clipboard
open override val n: Int? = null
Link copied to clipboard
val orientation: String? = null
Link copied to clipboard
val parameters: <Error class: unknown class>
Link copied to clipboard
val position: PosOptions?
Link copied to clipboard
open override val quantiles: List<Number>? = null
Link copied to clipboard
val sampling: SamplingOptions? = null
Link copied to clipboard
open override val scale: String? = null
Link copied to clipboard
open override val seed: Int? = null
Link copied to clipboard
open override val shape: Any? = null
Link copied to clipboard
open override val showHalf: Number? = null
Link copied to clipboard
Link copied to clipboard
open override val size: Number? = null
Link copied to clipboard
val stat: StatOptions
Link copied to clipboard
open override val stroke: Any? = null
Link copied to clipboard
open override val tailsCutoff: Number? = null
Link copied to clipboard
Link copied to clipboard
open override val trim: Boolean? = null
Link copied to clipboard
open override val violinWidth: Number? = null
Link copied to clipboard
open override val weight: Number? = null
Link copied to clipboard
open override val width: Number? = null
Link copied to clipboard
open override val x: Number? = null
Link copied to clipboard
open override val y: Number? = null