strategies / calibration

strategy 02 · calibration

The totals.

A candidate frame — its support built, before deployment — carries design weights that reflect the survey it came from, not the administrative totals a model needs to match. Calibration reweights it against thousands of hierarchical targets at once, by gradient descent on a capped relative-error loss, with hard bounds on how far any single weight can move.

paper: plan stage Read the paper Repository
01 — the 30-second version

One release, read live.

The numbers below come from the same release registry the homepage reads — populace-us-2024-5da5a95, calibrated against 3,704 administrative targets spanning Census, IRS, BEA, and state agencies. Calibration adjusts weights only: no target value is ever written into a record.

calibration loss 0.022from 1.831 at design weights capped relative-error loss, 3,704 targets
targets within 10% 94.7%from 22.2% at design weights before any reweighting, most targets miss by more than a tenth
max weight ratio 50×hard bound, enforced the landmine guard: no household's influence can run away

populace-us-2024-5da5a95 · calibration.json, generated 2026-06-15. 82 of 3,704 targets still miss by more than 50% after calibration — mostly thin families with few observations (rent-and-royalty net losses is the extreme case: 28 targets, 0% within 10%). The per-family breakdown below is the same table the release registry exposes; nothing here is rounded or selected for effect.

02 — the method

Bounded gradient descent, not classical calibration.

lossshipped

Capped relative error

Each target's contribution to the loss is capped, so a handful of targets with poor donor coverage cannot dominate the gradient and starve the rest of the surface of attention. Thousands of targets are fit jointly, not sequentially.

weight boundsshipped

Hard ratio bound against landmines

Design weights can move only up to a fixed multiple of their starting value (50× on the current release). Unbounded calibrators — including several classical methods — can send an individual weight arbitrarily high in pursuit of a thin target; the bound trades a small amount of in-fit accuracy for a hard cap on any one household's leverage.

hierarchyshipped

National, state, and program targets jointly

The target surface spans Census population counts, IRS SOI income and deduction totals, BEA wages, and state-level adjusted gross income and program administrative totals — fit as one surface, not reconciled in separate passes.

classical-calibration comparison (raking, GREG, entropy balancing, bounded chi-square) is the calibration-paper's plan — not yet run; see the paper page

The target surface feeds one bounded gradient-descent reweighting A hierarchical target surface — national totals from Census, IRS SOI, and BEA; state adjusted gross income and program administrative totals; program targets — is fit jointly as one surface by gradient descent on a capped relative-error loss with a hard 50-times weight-ratio bound. On the current release the loss drops from 1.831 at design weights to 0.022, and targets within 10 percent rise from 22.2 percent to 94.7 percent, across 3,704 targets. the target surface · 3,704 targets, one joint fit National totals Census population · IRS SOI income & deductions · BEA wages State totals adjusted gross income · program administrative totals Program targets agency administrative totals the operator gradient descent capped relative-error loss hard 50× weight-ratio bound adjusts weights only output calibrated weights at design weights after calibration loss 1.831 0.022 within 10% 22.2% 94.7%
The hierarchy — national, state, and program targets — is fit as one joint surface, not reconciled in separate passes. Gradient descent on a capped relative-error loss moves weights (never target values written into records) under a hard 50× ratio bound: the landmine guard that stops any one household's influence running away. On the current release, loss falls from 1.831 to 0.022 and targets within 10% rise from 22.2% to 94.7%.
03 — how it's scored

Two currencies, not one.

Calibration-target attainment (the numbers above) is one of the two validation currencies detailed on the evaluation strategy page — administrative targets hit, in-fit and held out. The other currency, support fidelity against survey holdouts under the popdgp harness, is calibration-blind by construction: it scores whether the weighted population still looks like the surveys that observe it, independent of whether calibration ever ran. Reading both pages together is the honest picture; neither one alone is.

Every target, every release.