Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Glossary

Every term the pipeline chapters define, in one place.

The chapters are written for engineers rather than statisticians. Where a plain description works as well as the textbook name, the description is what the prose uses — but the textbook name is recorded here too, because it is what you need if you want to read further about a method.

Terminology is deliberately narrow here: dispersion is the engine-reported precision attached to one point, while scatter is the between-commit variation of a reconstructed series. The terms are not aliases.

TermWhat it meansAlso calledIntroduced in
agreement shareThe fraction of before-and-after pairs that agree the level moved in the same direction.probability of superiorityNoise gates
blessingA recorded decision to treat a change as accepted, so earlier measurements no longer influence analysis.Reconstruction
censusThe report’s account of how many series it judged, and why it did not judge the rest.Reporting
chance levelHow often pure chance alone would produce a pattern at least this strong.p-valueDetection
change pointAn estimated location near which a series stops holding one level and starts holding another.Detection
comparison-base lagA branch comparison made against base data from several commits back.Reporting
confidence intervalA range the benchmark engine reports alongside a measurement to say how precisely it pinned it down.Noise gates
detectorThe procedure that examines one series for one shape of change: a change point, a drift, or a branch comparison.Detection
dirty runA measurement taken with uncommitted changes in the working tree.Collection
discriminant setThe engine, target triple, and machine key a run was measured with, which together decide what it may be compared against.Shape of the data
driftA series that moves steadily in one direction rather than stepping between levels.monotonic trendDetection
false-discovery familyIn history mode, every series that carried enough data to be tested: the group a statistical finding has to stand out from.Multiplicity and coverage
findingA reported move. A history finding survived the group-wide correction; a branch finding exceeded the current base range and survived every applicable gate.Reporting
ghostA benchmark that history remembers but the analyzed commit no longer measures.Reconstruction
group-wide correctionA stricter bar applied when many things are tested at once, so that only a small share of what is reported is expected to be wrong.Benjamini-Hochberg false discovery rate controlMultiplicity and coverage
harvestReading whatever output the benchmark engines left behind after a run.Collection
levelThe value a series sits at over a stretch of commits, ignoring run-to-run scatter.Detection
machine keyA fingerprint of the host hardware, used to keep incomparable results apart.Collection
medianThe middle value of a sample, which a few extreme measurements cannot drag around.Detection
merge baseThe newest commit a branch and its base still share.Selection
observed rangeThe lowest through highest values actually recorded in the current base regime.Detection
one-way-trend checkA test for whether a series mostly moves in one direction, which counts rises against falls rather than fitting a line.Mann-Kendall testDetection
outlier-resistant slopeA trend line fitted from the middle of all the pairwise slopes, so a few odd measurements cannot tilt it.Theil-Sen estimatorDetection
partitionOne discriminant set’s slice of the store.Collection
rank comparisonA test for whether two regimes differ that weighs each measurement by its rank among all of them rather than by its size, so a few extreme values cannot dominate. Tested two-sided.Mann-Whitney U testDetection
reference laneThe other half of the base observations, which the branch is compared against and which never helps choose that comparison.Detection
regimeA stretch of commits over which a series holds one level.Detection
scatterBetween-commit variation in a series when nothing has changed.Detection
selector laneThe half of the base observations allowed to decide where the current regime begins.Detection
seriesOne metric of one benchmark, tracked across commits.Reconstruction
split searchA scan for the single most likely place a series changed level.Pettitt testDetection
typical residualHow far a representative point sits from the history model fitted to the series: a level for a change point, a line for a drift.median absolute residualNoise gates

A note on what these are not

The definitions above are working descriptions, precise enough to follow what this tool does. They are not textbook definitions, and several deliberately gloss over conditions that do not arise here — a rank comparison, for instance, is described as evidence of a difference rather than as the assumptions the test makes about the data.

Where the distinction matters to how the tool behaves, the chapter says so at that point.