Where every number came from

Every figure on this map is fetched from the agency that produced it, by a script in atlas/etl/ that is committed alongside the result. Nothing is typed in by hand and nothing comes from somebody else's republication of a government file — with one stated exception, below, and the reason for it.

None of these need an API key. That is not a coincidence: a pipeline that needs a secret is a pipeline that stops working the moment the secret expires, and this one is meant to be re-runnable by anybody, from a clean checkout, with node atlas/etl/build-geo.mjs and node atlas/etl/build-data.mjs.

What is not here

Stated plainly, because a map that quietly omits things is worse than one that says what it lacks:

• Puerto Rico and the U.S. Virgin Islands are drawn at municipio and district level, but carry no economic series: neither the Bureau of Economic Analysis nor the Census Bureau's population estimates publish county-equivalent accounts for them in the tables used here.
• Canada is published by Statistics Canada as rates and medians, not as the totals they were computed from, so Canadian measures stop at the census division. A province's median household income has to come from Statistics Canada; it cannot be assembled from this map.
• Mexico's 2020 census collected no income variable, so the Mexican axes are about work, housing and language rather than money.
• Cross-border comparison is not offered. Canadian dollars, Mexican pesos and U.S. dollars are never converted, because a meaningful comparison needs a purchasing-power adjustment this project does not yet have. The continental view paints each country on its own scale from its own agency's data, and greys out the countries a given measure does not apply to.
• The Bureau of Economic Analysis merges some areas. About thirty Virginia independent cities are reported together with the county around them, and Kalawao with Maui. The pair's figure is stored on the lead county and shown on both halves, with a note in the detail panel. It is not split, because splitting it would mean inventing the parts.
• Six Mexican municipios created after 2018 have census data but no boundary in CONABIO's 2018 file, so they are absent from the map and from the national total shown here (125.8 million against the census's 126.0 million).

Citing this

Cite the agencies, not this page. Each card above carries the citation its publisher asks for. Where a figure is derived — a share, a rate, a per-capita — the derivation is in atlas/lib/measures.js and the arithmetic is in packages/geohier/hier.js; both are readable in a few minutes and neither does anything clever.