Define the population and quantity behind an evaluation score
Write an evaluation question as a population, system configuration, scoring rule, and estimand before choosing a dataset or release threshold.
On this page
The question for today
What you’ll understand
- Specify the target population and evaluation unit.
- Separate a population estimand from a finite-set statistic.
- Explain how weighting, budgets, and missing outcomes change the question.
A support assistant scores seventy percent on a balanced collection of two task types. The deployment workload is not balanced, and users have different consequences when either task fails. The number alone therefore does not answer whether the assistant is ready. Define the target quantity first: which requests, users, time window, model configuration, resource budget, and success rule the evaluation represents. A dataset score is evidence about that question only when the sampling and measurement process connects the observed cases to the declared population.
Name the estimand before the estimator
An estimand is the quantity the study intends to learn, such as expected rubric success for eligible requests arriving during a specified deployment period. Fix the system identity, including retrieval corpus, tools, prompt, decoding settings, and allowed retries. A model with a larger tool budget is a different evaluated intervention. The scoring rule can be binary, continuous, or a vector of outcomes, but define the unit and direction. An arithmetic average across examples is a statistic; interpreting it as a population performance estimate requires assumptions about how those examples were obtained.
Choose whether the unit is a request, conversation, user, repository, or another entity. Averaging all turns weights long conversations more heavily than averaging per-conversation scores. Likewise, one prolific user can dominate a request-weighted score while contributing one unit to a user-weighted estimand. Neither convention is inherently correct for every decision. Record the one that matches the release question and retain identifiers that make its denominator reconstructible. If deployment changes the mix of users or tasks, the old population target may no longer describe the new decision.
Keep target weights distinct from test composition
A test can deliberately oversample difficult or rare tasks to obtain useful evidence. Its raw mean then represents the test mixture, not automatically the deployment mixture. For a partition into task strata, combine stratum estimates using declared target weights when that population average is the question. Weights must cover the target population and sum to one; overlapping slices cannot simply be added as though they were a partition. Uncertain or changing population weights are another uncertainty source, not a correction supplied by making the test set larger.
Holistic Evaluation of Language Models emphasizes multiple scenarios and metrics because a single aggregate hides meaningful differences. Apply that principle to a concrete release: report the chosen aggregate together with important stratum estimates, support counts, and failure consequences. A weighted success rate does not encode every deployment constraint. A critical slice may require its own minimum evidence and gate even if its population share is small. Keep such decision rules explicit rather than conceal them inside an undocumented average or an attractive leaderboard rank.
Make nonresponses and deployment changes visible
Specify what happens when generation times out, a tool fails, or an annotator cannot score an answer. Dropping those records estimates performance conditional on successful processing or labeling, which may exclude the hardest requests. Alternatively, a declared end-to-end success rule can count particular system failures as failures while separately reporting their cause. Preserve both the eligible population count and the scored denominator. A confident estimate for one old workload does not establish performance under a changed retrieval source, language mix, or user behavior.
The sampling lab isolates the simplest measurement situation. For each separate view, Reset, set both p=0.6 and n to 25 or 100, predict the variance, then inspect. Its exact Bernoulli sample-mean variances are 0.0096 and 0.0024. There is one fixed population probability, independent identical trials, and no weighting, missingness, or deployment shift. The instrument makes finite sampling variation visible; it cannot choose the appropriate estimand or turn an unrepresentative convenience test into a representative one. Those choices belong in the study protocol before results are read.
Work it through
A balanced test and the deployment population answer different questions
A fictional deployment has 80% routine questions and 20% complex questions. A frozen assistant succeeds on 90% of routine cases and 50% of complex cases. A deliberately balanced test has equal counts from both strata; treat these stratum rates as stipulated for this arithmetic example.
The unweighted balanced-test average is 0.5×0.9+0.5×0.5=0.70, or 70%. It describes that balanced mixture.
The target-weighted deployment quantity is 0.8×0.9+0.2×0.5=0.82, or 82%, under the stated target shares and stratum rates.
The complex stratum still has 50% success. Its separate support, uncertainty, and release requirement remain relevant even though the weighted aggregate is higher.
The same stratum performance yields 70% for a balanced mixture and 82% for the stated deployment mixture. Selecting an estimand determines which aggregate is meaningful; it does not remove slice failures.
The living notebook
Explore the model
Interactive lab · sampling
Separate sampling precision from the population question
For each view: Reset, set both p=0.6 and n, predict, then inspect. Compare n=25 with n=100; exact sample-mean variances are 0.0096 and 0.0024. This independent Bernoulli model has no target weights, missing outcomes, or distribution shift. Playback highlights outcomes without collecting random data.
- Mean sample proportion
- 0.5
- Sample-mean variance
- 0.0125
- Uniform CDF error bound
- ≤ 0.1062
Exact binomial masses for the mean of n independent Bernoulli trials, compared with normal mass between adjacent half-count boundaries; normal tails outside the finite support remain outside the bars. Playback highlights outcomes, not random samples. The Berry–Esseen bound applies to standardized CDFs, not individual bars or continuity-corrected errors. At p = 0 or 1, normal comparison and that bound are disabled. Normal-CDF evaluation uses a numerical approximation with absolute error below 7.5×10⁻⁸ (at most 1.5×10⁻⁷ per interval, before rounding). Parameter changes pause playback and recompute the model at the current elapsed time. Reset restores both parameters and returns time to zero. Playback starts paused. Adjust either parameter, then choose Play or Step.
Look forMore independent samples improve precision for the stipulated population. They do not determine which population or score should be measured.
Pause & reason
Check your understanding
Your turn
Try it yourself
A target population has 60% task A and 40% task B, with stipulated success rates 75% and 25%. Compute the target-weighted score and the balanced-mixture score.
Take a moment to make a prediction or work it out on paper. Open a hint when you need one.
Give me a hint
Use the target shares for one calculation and equal shares for the other.
Compare with the solution
The target score is 0.6×0.75+0.4×0.25=0.55. The balanced score is 0.5×0.75+0.5×0.25=0.50. Neither calculation establishes whether the sampled stratum rates generalize or meet a critical-slice requirement.
Keep the idea
Take it with you
- An estimand fixes the population, system, scoring rule, and evaluation unit.
- Test composition and target population weights are separate design choices.
- Precision does not repair missing outcomes, an incorrect denominator, or distribution shift.
Read further
Original sources and deeper explanations to follow at your own pace.
Optional progress, saved in this browser when available. Revisit any lesson at any time.
Lesson not marked complete.