# US States population atlases

51 maps: all 50 states plus the District of Columbia. US territories are not part of this mode. Maps load individually through `catalog.json`; `file` paths are relative to `/data/`.

Population weights come from the European Commission Joint Research Centre's **GHS-POP R2023A, epoch 2020, 30 arcseconds** raster. Native nonnegative counts whose cell centers lie inside each unsimplified boundary are summed, then aggregated only when needed to keep a map below 10,500 positive cells and 500 KB. Integer rounding preserves each native masked population total. These are modeled 2020 populations, not current census totals. The game treats population as uniform inside each exported rectangular cell when the dividing line crosses it.

Boundaries and city labels come from Natural Earth 1:10m Admin 1 and populated places, pinned to commit `ca96624a56bd078437bca8184e78163e5039ad19`. Natural Earth is public domain; GHS-POP is CC BY 4.0. Coastline and cell-center masking introduce small coastal assignment differences. Great Lakes do not add synthetic residents.

Alaska includes the Aleutians, with western islands unwrapped across the antimeridian. Original raster columns wrap by one 43,200-cell rotation; its floating-point difference from exactly 360 degrees is less than 0.000002 degrees. Hawaii includes the eight main islands and adjacent islets, and explicitly excludes the remote Northwestern Hawaiian Islands to keep the inhabited islands readable. DC keeps native resolution.

Sources, SHA-256 checksums, access date and per-map scope are recorded in `provenance.json` and each map. Rebuild using `scripts/data-subdivisions-build.py`; validate all groups using `scripts/data-subdivisions-verify.py`.

- Population: <https://human-settlement.emergency.copernicus.eu/ghs_pop2023.php>
- DOI: <https://doi.org/10.2905/2FF68A52-5B5B-4A22-8F40-C41DA8332CFE>
- Population license: <https://creativecommons.org/licenses/by/4.0/>
- Boundaries: <https://www.naturalearthdata.com/downloads/10m-cultural-vectors/10m-admin-1-states-provinces/>
- Boundary license: <https://www.naturalearthdata.com/about/terms-of-use/>
