Skip to content

Add US quickstart notebook#273

Merged
MaxGhenis merged 1 commit into
mainfrom
examples-quickstart
Jul 2, 2026
Merged

Add US quickstart notebook#273
MaxGhenis merged 1 commit into
mainfrom
examples-quickstart

Conversation

@MaxGhenis

Copy link
Copy Markdown
Contributor

A Colab-ready quickstart at examples/quickstart_us.ipynb: install, download the published populace_us_2024.h5 via the Hugging Face registry, build a Microsimulation, compute 2025 national aggregates and the SPM poverty rate, and score a CTC $2,200 → $3,000 reform for 2026.

Verified by executing end-to-end in a fresh venv (policyengine-us 1.754.0) against the current published artifact (sparse L0-refit 57,240-household release):

population               343.2M
adjusted gross income $  16.01T
federal income tax    $   2.15T
household benefits    $   1.99T
SPM poverty rate 2025: 13.7%
CTC $2,200 -> $3,000 (2026): federal cost $32.8B

Outputs are committed so the notebook previews with real numbers; the install cell's output is stripped (environment-specific). Once populace-data wheels publish to PyPI, the download cell can switch to populace.data.load("us", 2024).

🤖 Generated with Claude Code

Executed end-to-end against the published populace-us artifact with
policyengine-us 1.754.0: downloads the H5 from the Hugging Face
registry, computes 2025 national aggregates and the SPM poverty rate,
and scores a CTC $2,200 -> $3,000 reform for 2026. Outputs are
committed so the notebook previews with real numbers.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@MaxGhenis MaxGhenis merged commit 34bdfcb into main Jul 2, 2026
4 checks passed
@MaxGhenis MaxGhenis deleted the examples-quickstart branch July 2, 2026 13:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant