violin

Multiplies the density-derived half-width of each violin. At 1, a curve's own peak density maps to half the category slot. Values above 1 widen the curves, below 1 narrow them.

Kernel density estimation, used only when the density is derived from raw observations: a datum supplying points, or a flat number array as y. A precomputed density profile is drawn exactly as given and ignores this.

Requires the optional stats feature, which the default apexcharts bundle already includes.

Kernel width in value units. Unset uses Silverman's rule of thumb.

This is the statistical parameter, and it changes the shape of the estimate: too small and the curve turns spiky, too large and real structure is smoothed away. bandwidthScale is unrelated, it only scales the drawn width.

Density samples per violin.

How violin widths are scaled across the series.

Available Options:

• 'individual' (default): each violin is scaled to its own peak, so every curve fills the slot regardless of sample size.
• 'group': all violins share one scale (the densest in the series), keeping widths proportional to density across categories.

Individual observations ("jitter") overlaid on the violin shape. The raw values come from the points array on each data point's y.

Render the jitter dots over each violin.

Available Options:

• true (default)
• false

Marker shape for each observation.

Available Options:

• 'circle' (default)
• 'square'

Marker radius in pixels.

Horizontal scatter of the dots as a 0..1 fraction of the violin's half-width. 0 stacks every dot on the centre line.

Clamp the jitter to the density width at each value so dots stay inside the curve outline.

Available Options:

• true (default)
• false

Cap on the number of dots drawn per violin. Observations beyond this are stride-thinned (evenly sampled) so dense groups stay performant.

Opacity of the dots, from 0 to 1.

Fill colour of the dots. Accepts 'series-dark' (a darker shade of the violin's own colour), 'series' (the violin's colour as-is), or any literal colour string such as '#fff'.

Colour of the ring around each dot.

Width of the dot outline in pixels. 0 disables the outline.

Colour each dot by its value along a ramp, overriding fillColor. Dots are bucketed into steps shades to keep rendering fast.

Hex colour stops, ordered low → high.

Value mapped to the first colour stop. Defaults to the data minimum.

Value mapped to the last colour stop. Defaults to the data maximum.

Number of shade buckets between min and max.