Notation and formula card
This card collects the handbook's notation and formulas in one place. The first half fixes the symbols: the five tuples of the evaluator system, the rules for letters that mean different things in different layers, and the conventions for rates and margins. The second half is a formula card grouped by the job each formula does.
Each formula appears in the same form as in the chapter that develops it, with a link to that chapter, the published source where there is one, and the calculator that computes it, if one exists. Calculators live in their chapters, the most used also have pages of their own, and the glossary gives every term in words.
The five tuples#
The evaluator system#
This handbook writes the evaluator system as five layers:
where each coordinate is a layer with its own question:
| Symbol | Layer | The question it answers | Home |
|---|---|---|---|
| Claim | What property, over what world, for what decision? | Constructs, facets, and nuisances | |
| Instrument | How is the judgment produced? | Specification | |
| Regime | What causal role does the signal play, and what happens when the system adapts to it? | Exposure, modification, and access | |
| Validation | Why believe the signal means what we claim, before and after adaptation? | The validation profile | |
| Lifecycle | Does validity survive over time, and are we still evaluating the right thing? | Channels and independence |
The evaluator system explains the master object. The lifecycle layer has no tuple: its controls are the O/A/P channels, anchor-burn accounting, tripwires, versioning, and frame review (Living eval suites, Frame review and governance).
The claim#
where:
| Symbol | Name | Meaning | Home |
|---|---|---|---|
| Construct | The latent property the evaluation intends to measure | Constructs | |
| , | Facets and nuisances | What the score should track, and what it must not respond to | Constructs |
| Population | The task, user, or input distribution the claim is about | Validity domain | |
| Environment | External state, tools, and other actors | Validity domain | |
| Harness | Prompts, tools, memory, orchestration, and stopping logic around the model | Validity domain | |
| Validity domain | The declared conditions under which the interpretation is claimed to hold | Validity domain | |
| Decision | The decision the evidence is meant to change | Decision claims |
The instrument#
where:
| Symbol | Name | Meaning | Home |
|---|---|---|---|
| Specification | The operational statement of what counts as success | Specification | |
| Predicate | The specification read as a test: when satisfies it | Specification | |
| Anchor | What the comparison is rooted in | Anchors and evidence views | |
| Evidence view | What the evaluator may observe | Anchors and evidence views | |
| Mechanism | What computes the judgment | Mechanism families | |
| Signal | What leaves the evaluator: verdict, score, preference, vector, critique | Signals and resolution | |
| Resolution | The unit judged: step, action, artifact, trajectory, or rate | Signals and resolution | |
| Aggregation geometry | How criterion-level judgments become a decision, with thresholds | Aggregation geometry |
A rubric is the specification in rubric form, : criterion, allowed evidence, exemplar anchors or scale, and gate semantics for each of criteria (Rubrics and criterion cards).
The regime#
where:
| Symbol | Name | Meaning | Home |
|---|---|---|---|
| Consumer | Who or what acts on the signal | Exposure and surfaces | |
| Optimizer | Who adapts against the signal | Exposure and surfaces | |
| Exposure budget | How much optimization pressure, in the optimizer's own unit | Exposure and surfaces | |
| Modification surface | Everything the optimizing loop can change | Exposure and surfaces | |
| Information access | What flows from the evaluator or anchor back to the optimizer | Exposure and surfaces | |
| Cost and latency envelope | What each evaluator call may cost, and how fast it must answer | Exposure and surfaces |
The regime's three values are measure, optimize, and monitor-control (Use regimes).
The validation profile#
where:
| Symbol | Name | Meaning | Home |
|---|---|---|---|
| Natural error | Confusion matrices, calibration, and slice error on the target distribution | The validation profile | |
| Exploitability curve | Evaluator–anchor divergence as optimization exposure grows | Adaptive validity | |
| Transport | Whether error rates carry over across generators, slices, time, and environments | The validation profile | |
| Generator coupling | Whether the evaluator errs where the generator errs | Goodhart and self-confirming loops | |
| Channel coupling | Dependence among supposedly independent assurance channels | Channels and independence | |
| Drift and saturation | How calibration and discrimination degrade, and when the range is exhausted | Living eval suites |
Inside , name the exploitability curve, channel coupling, drift profile, and generator coupling in words; the letters collide with the claim's.
Collision rules#
The same letter often carries different meanings in different layers. The rules below keep one meaning per page; where a formula uses a letter locally, its "where" list fixes the meaning.
| Symbol | Meanings in this handbook | Rule |
|---|---|---|
| Consumer in ; chance-corrected agreement | Bare is the consumer, only inside . Always write Cohen's κ for agreement. | |
| Evidence view ; verifier ; value (and ); validation layer | Plain is the evidence view. The others always carry their subscript, superscript, or script letter. | |
| Resolution ; regime | Plain is resolution, and the regime is always . An expert's value is and a judge's rubric is , never . | |
| Anchor ; information access ; anchor channel A of O/A/P; exemplar anchors ; an action | Qualify every "anchor" in prose: reference anchor, anchor channel, exemplar anchors, or linking items. | |
| , | Population ; pass or base rate ; nominal density in importance sampling; failure probability | Write probabilities as so that stays the population. |
| , | Specification ; the same specification as a predicate | Never write the specification as . |
| , , , , | Claim: environment, construct, validity domain. : exploitability, channel coupling, drift, transport, generator coupling. Validity statement: evaluator system, claim, domain, trust root. Coupling diagnostics: evaluator , generator . Chain links: task success , positive grade | Write 's components and the statement's slots in words. |
| Modification surface ; system behavior | The aggregate score is written , never . | |
| , | Trajectory ; thresholds and a flag threshold ; parameters in and | Thresholds are , never ; as a subscript names parameters. |
| , | TPR and FPR in selection and alert formulas; is also an objective, a density , and a learned scorer | and mean TPR and FPR only where the "where" list says so. |
| , | Exposure budget and McNemar's discordant count ; decision , a disturbance , and the smallest difference that matters | McNemar's and are counts. Read from its formula. |
| , | Significance level, quantile level, conformal miss rate, Beta prior, and system effect ; Beta prior, power , KL price, and expert consistency | Local to each formula. |
Conventions#
- Pass rates. is the true rate on the claim's population, or a base rate; is an estimate; is a judge's raw reading; is a failure probability. A sampled rate always carries its interval and n, as in the illustrative 80% (95% Wilson CI 71–87%, n = 100).
- Error rates. TPR and FPR are written and in the sensor formulas and and in the selection and alert formulas. Specificity, or TNR, is (sensitivity and specificity).
- Trajectories. , with states and actions (Evaluating agents).
- Margins. is a signed robustness margin: positive when satisfies , negative when it violates it, and its size says by how much (Specification).
- Exploitability. is the evaluator's disagreement with an independent anchor at exposure , and is the largest tested exposure before that divergence exceeds a predeclared tolerance (tested exposure). Report with the tested range, never as "robust".
- Typography. Multi-letter names are upright, as in and ; is a probability, an expectation, and is 1 when its condition holds and 0 otherwise.
Formula card#
Each entry gives the formula, a "where" list, when it applies, the published source where there is one, the chapter that develops it, and the calculator that computes it, if one exists.
Estimating a rate and its interval#
Target and observed pass rate#
where:
- is the system's behavior on task , drawn from the claim's population ;
- is the outcome of task among independent tasks.
estimates the never-observed only when the tasks represent ; a suite drawn from another distribution estimates instead (Task distributions and dataset engineering).
Chapter: Estimands, pass rates, and intervals