Qu

beeswarm

Builtin index · Plotting

beeswarm(data, ...), [spread=], [ms=], [marker=], [fill=]

Input: data, ... · Output: no output

What it is

Every sample drawn, nudged sideways only as far as it must be to clear its neighbours, so the WIDTH is the count. The middle ground between a box (hides the sample) and a raincloud (shows it, but scattered at random). Best below a few hundred points per group.

Overloads

One call shape — this function is not overloaded.

CodeInputOutputDescription
beeswarm(data, ...), [spread=], [ms=], [marker=], [fill=]
data —not documented yet
... repeatablenot documented yet
no outputEvery sample drawn, nudged sideways only as far as it must be to clear its neighbours, so the WIDTH is the count. The middle ground between a box (hides the sample) and a raincloud (shows it, but scattered at random). Best below a few hundred points per group.

Examples

No documentation example calls this form yet. The Plotting chapter is where one belongs.

How it works

beeswarm(data) / beeswarm(data1, ...) -- every sample drawn, nudged sideways only as far as it must be to avoid its neighbours. The gap between a boxplot and a raincloud. A box hides the sample; a raincloud's rain shows it but scatters it at random, so density has to be read from how dark the smear is and two points can land on top of each other. A swarm makes the WIDTH the count, which is the thing being read. Best below a few hundred points per group: past that the rows saturate and a violin says the same thing in less ink.

From the note above this builtin in the interpreter, where the reasoning was written down as it was built.