Datasetpublic

policyengine/microcosm-us-sources

Microcosm US build sources Processed Current Population Survey Annual Social and Economic Supplement (CPS ASEC) files that the PolicyEngine Microcosm US build reads as inputs to its base stage (tools/build_us_puf_support_base.py --asec-h5 YEAR=PATH in PolicyEngine/microcosm). They are mirrored here unchanged so that the build's inputs do not exist on one machine only. Microcosm pins each file by repository revision, SHA-256 and size, and refuses a file whose digest differs.… See the full description on the dataset page: https://huggingface.co/datasets/policyengine/microcosm-us-sources.

sourceHugging Facecc-by-4.0updated 4d agoView on Hugging Face

0likes37downloads

Dataset Card

Microcosm US build sources

Processed Current Population Survey Annual Social and Economic Supplement (CPS ASEC) files that the PolicyEngine Microcosm US build reads as inputs to its base stage (tools/build_us_puf_support_base.py --asec-h5 YEAR=PATH in PolicyEngine/microcosm).

They are mirrored here unchanged so that the build's inputs do not exist on one machine only. Microcosm pins each file by repository revision, SHA-256 and size, and refuses a file whose digest differs.

Files

File	Survey year (income year)	Bytes	SHA-256	Households	Persons
`census_cps_2024.h5`	ASEC 2025 (2024)	323,994,739	`ec36604cb735a660b51b0b2f90be27d803b5878f3464fb30d0eacead59c1260d`	55,762	142,125
`census_cps_2023.h5`	ASEC 2024 (2023)	299,036,610	`cb57817327799f42b741caed5f9be94d04021c2e6809c1ad7bd0686da5428d88`	56,251	144,265
`census_cps_2022.h5`	ASEC 2023 (2022)	301,129,278	`7ccca976284bb47815d84460cc4f75a0a65d26d7754ab0a0f417de351b3d474e`	56,839	146,133

Household and person counts are the ones the Microcosm base stage recorded when it read these exact bytes on 16 September 2026.

Provenance

Each file is an HDF5 store of the person, family and household tables of the Census Bureau's public-use CPS ASEC release for that year:

—2024: https://www2.census.gov/programs-surveys/cps/datasets/2025/march/asecpub25csv.zip
—2023: https://www2.census.gov/programs-surveys/cps/datasets/2024/march/asecpub24csv.zip
—2022: https://www2.census.gov/programs-surveys/cps/datasets/2023/march/asecpub23csv.zip

They were produced by PolicyEngine's retired US data package's Census CPS loader. The exact commit of that loader that wrote each file was not recorded, so these files are pinned by their bytes, not by a rebuild recipe. The PolicyEngine organisation publishes earlier files with the same names in another repository; those have different bytes and are not interchangeable with these.

Licence and source terms

The underlying data are public-use microdata from the US Census Bureau and are in the public domain in the United States. PolicyEngine's processed files are offered under CC BY 4.0. The Census Bureau does not endorse this product.