Skip to content

Read life-expectancy and usa-gini from data-lectures - #56

Merged
mmcky merged 1 commit into
mainfrom
datasets/track-a-remainder
Aug 12, 2026
Merged

mmcky merged 1 commit into
mainfrom
datasets/track-a-remainder

Conversation

@mmcky

@mmcky mmcky commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Wave A4 of the datasets migration. The last two Track A CSVs moved to QuantEcon/data-lectures in QuantEcon/data-lectures#74, which is merged and serving both files. Three URLs.

All three land on raw.githubusercontent.com — one spelling for reads and {download} roles alike, matching the decision taken during the high_dim_data fold. It drops a redirect hop and avoids the two-hosts-in-one-file split that the "harmonise these forms" class of fix has broken before. This does differ from the older github.com/…/raw/ form used by earlier repoint sets; harmonising those is a separate sweep, deliberately not this PR.

Left alone on purpose

simple_linear_regression.mdcols = ['Code', 'Year', 'Life expectancy at birth (historical)', 'GDP per capita']. The migrated bytes are byte-identical to intro's, so the old column label is still the correct one. Upstream OWID has since renamed four of eight columns, moved the annotations column, and halved the row count; that delta is recorded in the new manifest and registered on QuantEcon/data-lectures#39. Adopting it would change every life-expectancy value while leaving the 2018 scatter looking identical — a content change with re-reviewed figures, not a repoint.

inequality.md — the [This notebook] link to intro's _static/lecture_specific/inequality/data.ipynb. It points at a notebook, not a dataset, and that notebook stays in lecture-python-intro.

Verification

Line numbers re-derived immediately before editing, not carried from a table. Both targets serve HTTP 200 with access-control-allow-origin: *, and their sha256 match the manifests exactly (ec5d3235…, bed9074a…).

Old and new URLs produce identical frames under the lecture's own code — stronger than checking the URL returns 200:

Read Old → New
read_csv(data_url, nrows=10) (10, 8) vs (10, 8), equals: True
read_csv(data_url, usecols=cols) (62156, 4) vs (62156, 4), equals: True
…then .dropna() 12,445 vs 12,445 — which is what the prose asserts
…then Year == 2018 (the fitted scatter) 166 vs 166 rows, equals: True
read_csv(data_url, index_col='year') (20, 3) vs (20, 3), identical index

So this provably cannot change a figure.

Also checked: the commit carries both the added and removed URL lines in each file (a scripted repoint has silently shipped deletions-without-URL-change before), and no reference to intro's copies of either file remains.

Why this repo is in the set at all

It does not build either lecture — _toc.yml is trimmed to five lectures and _config.yml sets only_build_toc_files: true — so nothing here can go red on a bad URL, and no CI of any kind sees these lines. Everything above was verified by hand.

The reason it matters is ordering. This repo reads intro's committed copies, and intro is about to delete them. Repointing here is the precondition for that deletion: doing it earlier would point at files that did not exist yet, and doing it later is exactly the failure QuantEcon/workspace-lectures#28 recorded — two published QuantEcon sites left serving 404s because a deletion sweep was described as org-wide when it had covered nine clones.

This repo has been dropped from a count in this programme three separate times. It is a real consumer.

Merge together with

QuantEcon/lecture-python-intro#834 and QuantEcon/lecture-wasm, same branch name.

Tracking: QuantEcon/workspace-lectures#23

Wave A4 of the datasets migration: the last two Track A CSVs moved to
QuantEcon/data-lectures in QuantEcon/data-lectures#74, which is on `main` and
serving both files. Three URLs.

All three land on `raw.githubusercontent.com` — one spelling for reads and
downloads alike, matching the decision taken during the high_dim_data fold. It
drops a redirect hop and avoids the two-hosts-in-one-file split that the
"harmonise these forms" class of fix has broken before. Note this differs from
the older `github.com/.../raw/` form used by earlier repoint sets in this repo;
harmonising those is a separate sweep, not this PR.

Left alone on purpose:

  simple_linear_regression.md  `cols = [... 'Life expectancy at birth
    (historical)' ...]`. The migrated bytes are byte-identical to intro's, so
    the old column label is still correct. Upstream OWID has since renamed four
    of eight columns and halved the row count; that delta is recorded in the
    new manifest and registered on QuantEcon/data-lectures#39. Adopting it is a
    content change, not a repoint.

  inequality.md  the `[This notebook]` link to intro's
    `_static/.../data.ipynb`. It points at a notebook, not a dataset, and that
    notebook stays in lecture-python-intro.

Verified rather than assumed. Line numbers re-derived immediately before
editing. Both targets serve 200 with `access-control-allow-origin: *` and
sha256 matching the manifests (ec5d3235… / bed9074a…). Old and new URLs produce
IDENTICAL frames under the lecture's own code: both read_csv calls in
simple_linear_regression (10x8 and 62156x4), `.dropna()` at 12,445 rows — which
is what the prose asserts — the `Year == 2018` filter at 166 rows that drives
the fitted scatter, and inequality's 20x3 with an identical index. So this
cannot change a figure.

This repo does not build either lecture — _toc.yml is trimmed to five and
_config.yml sets only_build_toc_files: true — so nothing here can go red on a
bad URL. The repoint is source hygiene and, more importantly, the precondition
for deleting intro's copies: leaving these pointing at files that are about to
be deleted is exactly the failure QuantEcon/workspace-lectures#28 recorded.
Copilot AI lite review requested due to automatic review settings August 12, 2026 00:31

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR continues the Track A dataset migration by repointing the remaining lecture references for life expectancy and USA Gini CSVs from QuantEcon/lecture-python-intro to the consolidated QuantEcon/data-lectures location, using the raw.githubusercontent.com URL form consistently.

Changes:

  • Updated the {download} link and data_url in simple_linear_regression.md to the data-lectures raw URL for life-expectancy-vs-gdp-per-capita.csv.
  • Updated the data_url in inequality.md to the data-lectures raw URL for usa-gini-nwealth-tincome-lincome.csv.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
lectures/simple_linear_regression.md Repoints the life expectancy vs GDP per capita CSV URL (download link + code cell) to QuantEcon/data-lectures via raw.githubusercontent.com.
lectures/inequality.md Repoints the USA Gini/wealth/income CSV URL in the code cell to QuantEcon/data-lectures via raw.githubusercontent.com.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@github-actions

Copy link
Copy Markdown

📖 Netlify Preview Ready!

Preview URL: https://pr-56--jade-tarsier-d98a19.netlify.app

Commit: e3c8bf1


Build Info

@mmcky
mmcky merged commit 740ef13 into main Aug 12, 2026
2 checks passed
mmcky added a commit to QuantEcon/data-lectures that referenced this pull request Aug 12, 2026
All four consumers now read
raw.githubusercontent.com/QuantEcon/data-lectures/main/lectures/, so the two A4
records move landed -> repointed and both manifests gain their consumers.

THIS PR IS THE WAVE'S ACCEPTANCE TEST, not bookkeeping after it. Run locally in
both directions against the four now-merged consumer repos, before pushing:

  status: landed     -> exit 1, 2 warnings ("marked landed but some consumer
                        already reads data-lectures")
  status: repointed  -> exit 0, 0 warnings

So the red window was real, opened when the first consuming PR merged, and this
closes it. A non-zero strict audit also skips the Pages deploy, and Pages serves
lectures/ as well as the dashboard, so the served data tree would have gone
stale alongside it.

Repoints recorded: QuantEcon/lecture-python-intro#834, QuantEcon/lecture-wasm#61,
QuantEcon/lecture-intro.zh-cn#294, QuantEcon/test-actions-lecture-intro#56.

All four consumers are recorded per manifest, not the two the scan can see —
the convention set by the P3 fold. lecture-intro.zh-cn and
test-actions-lecture-intro are outside SCAN_REPOS, so migration.yml and the
manifests are the only place they exist. Safe because build_audit derives its
own consumer list from the scan and never asserts on the manifest's; the
audit's own count for these two files stays 2.

The generated lecture-python-intro.notebooks mirror is a FIFTH reference-holder
and is deliberately not listed: nobody repoints it, and it self-heals after
intro's next publish tag. Recorded as a comment in both manifests so the
omission reads as a decision rather than an oversight.

Post-flip figures: migrated 24 -> 26, committed_files 43 -> 41 (lecture-wasm
deleted its two mirror-orphans in its repoint PR), orphans unchanged at 26,
CATALOG.md "26 read by lectures today" with no awaiting-repoint remainder.

consumed-file-check: 26 manifests, 27 files hash-checked, 0 errors. Catalog
freshness gate green.

WHAT THIS DOES NOT DO: nothing is deleted. lecture-python-intro still holds the
only live copy of both files, and deleting them is gated on FOUR publishes —
intro, lecture-intro.zh-cn and the canary are all tag-gated, and merging a
repoint changes main, not a published site. lecture-wasm self-heals on merge.
Track A's third item, graph.txt, is untouched and is not a data-lectures
migration at all.
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.

2 participants