PolicyEngine / PolicyEngine/chronicle

Add ECB HFCS Wave 2023 Belgium wealth facts

Open
#215 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
0
Forks
1
Avg merge
11h 48m
Merged PRs (30d)
45

Description

Refs #69.

Source gap

Chronicle has no official Belgium HFCS net-wealth/distribution/component
aggregate package. No ECB wave-2023 workbook bytes or checksum are present on
current main or in the inspected branches, so values must not be copied from
the rendered statistical tables.

Deterministic handoff

Retrieve the official ECB HFCS Wave 2023 statistical-tables ZIP, version 5.0
(June 2026), through the ECB entry in
FETCH-MANIFEST-BELGIUM-PUBLIC-FACTS.json:

https://www.ecb.europa.eu/home/pdf/research/hfcn/HFCS_Statistical_Tables_Wave_2023_June_2026.zip

Acceptance criteria

  • Pin the unchanged outer ZIP with URL, SHA-256, size, ECB version/vintage, and
    content-addressed raw-storage pointer. List archive members deterministically
    and pin each selected native workbook member separately.
  • Inspect workbook sheet names, row/column labels, units, weighting labels, and
    cells before authoring. Belgium asset/liability values refer to interview
    time during January-December 2023; income variables refer to 2022.
  • Add only ECB-published Belgium net-wealth means/medians/quantiles,
    distribution shares/ratios, and component aggregates with exact source-cell
    lineage and survey_aggregate provenance.
  • Do not interpolate quantiles, derive components or totals, reconcile to NBB,
    age values, or add model/target bindings.
  • Run validate-package, source-cell preservation, fact-load,
    consumer-artifact, raw-facts-boundary, ruff, and git diff --check checks.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with FETCH-MANIFEST-BELGIUM-PUBLIC-FACTS.json and retrieve the specified ECB HFCS Wave 2023 version 5.0 ZIP. Inspect its archive members and selected workbook sheets, labels, units, weights, and source cells before adding only the permitted Belgium aggregates. Done means pinned source metadata and lineage are present, and validate-package, preservation, fact-load, consumer-artifact, boundary, ruff, and git diff --check pass.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
data
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Clearly specified
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.