Qu

histogram

Builtin index · Plotting

hist(samples, [bins])

Input: samples, bins · Output: no output

What it is

Bins samples (Vec of numbers) into equal-width buckets and renders as bars; bins (integer, positional or bins= keyword) defaults to ceil(sqrt(n)) for n = len(samples).

Overloads

One call shape — this function is not overloaded.

CodeInputOutputDescription
hist(samples, [bins])
samples Vec or numberBins samples (Vec of numbers) into equal-width buckets and renders as bars.
bins optionalbins (integer, positional or bins= keyword) defaults to ceil(sqrt(n)) for n = len(samples).
no output—

Examples

From the documentation, and run by the build -- the output and the figure below are what the engine actually produced. Simplest first.

group_a = randn(40, seed = 11)
group_b = randn(40, seed = 12) + 0.5
group_c = randn(40, seed = 13) - 0.3
panel(1, 2, 1)
histogram(y, 20)
panel(1, 2, 2)
boxplot(group_a, group_b, group_c)
output
· histogram: figure 57 (6 points, 20 bins)
0 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0 0 2 3 4 x=0.12, y=1 x=0.36, y=0 x=0.6, y=0 x=0.84, y=0 x=1.08, y=0 x=1.32, y=1 x=1.56, y=0 x=1.8, y=1 x=2.04, y=0 x=2.28, y=0 x=2.52, y=0 x=2.76, y=0 x=3, y=1 x=3.24, y=0 x=3.48, y=1 x=3.72, y=0 x=3.96, y=0 x=4.2, y=0 x=4.44, y=0 x=4.68, y=1 -2.0 -1.5 -1.0 -0.5 0 0.5 1.0 1.5 2.0 2.5 3.0 0 300 600 900 -1.0 -0.8 -0.6 -0.4 -0.2 0 0.2 0.4 0.6 0.8 1.0 0 2 3 4 x=0, y=0 x=1.8, y=0.063 x=1.2, y=0.126 x=3.5, y=0.188 x=3, y=0.249 x=4.8, y=0.31 0 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0 0 10 20 30 40

from plotting

How it works

hist(samples) / hist(samples, bins) bins raw samples into equal-width buckets and renders as bars -- distinct from bar, which takes already-aggregated (x, height) pairs.

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

See also

hist — documented in the same entry.