Skip to content

Add Populace pipeline overview brief and figure#5

Open
vahid-ahmadi wants to merge 1 commit into
mainfrom
populace-pipeline-overview
Open

Add Populace pipeline overview brief and figure#5
vahid-ahmadi wants to merge 1 commit into
mainfrom
populace-pipeline-overview

Conversation

@vahid-ahmadi

Copy link
Copy Markdown

Summary

Adds a self-contained brief describing Populace and the calibration pipeline, for use as talk background and a repo reference. Companion to the L0 paper draft.

  • paper/populace_overview.md — pipeline overview in README tone:
    • what Populace is + the five-package architecture (frame, data, fit, calibrate, build)
    • the Frame spine (typed weights, strata/provenance, weighted accounting)
    • the six pipeline stages, prior to and including calibration: sources → combine → impute → geography → build targets → calibrate
    • the L0 calibration step (the loss, Hard Concrete gates, λ_L0/λ_L2, target_records budget control)
    • the four-method sampling experiment (informed L0 vs. random→reweight vs. survey-weight sampling vs. combinatorial optimization)
    • a Statistics section covering the points the method has to defend (L0/Hard Concrete relaxation, samplers in survey-statistics terms, out-of-sample validity, correlated evidence, metrics)
  • paper/figures/populace_pipeline.png — pipeline overview figure (slide-ready)
  • paper/figures/populace_pipeline.py — its matplotlib generator (uv run --with matplotlib python paper/figures/populace_pipeline.py)

Content is grounded in populace/DESIGN.md, paper/sections/data.tex, paper/sections/methodology.tex, the live populace-calibrate solver, and paper/sampling_lit_review.md.

Notes

  • Docs/figure only — no changes to paper sections or code.
  • Uses Populace naming; the data.tex/methodology.tex drafts still say \microplex.

🤖 Generated with Claude Code

Add a talk/reference brief describing Populace and the calibration
pipeline (sources -> combine -> impute -> geography -> build targets ->
calibrate), the L0 calibration step, the four-method sampling experiment,
and a Statistics section covering the points the method has to defend.

Add a generated pipeline overview figure and its matplotlib generator.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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