← Back to NL country layer · Country index
Synthestat · Netherlands · latest run

nl_population_review_cycle1_fa78aabf_seed420987

Local run directory: /home/synthestat/output/runs/NL/nl_population_review_cycle1_fa78aabf_seed420987

This static page mirrors the run diagnostics/messages so they are clickable from the QA dashboard.

Output status

PeopleHouseholdsDwellingsHouses/buildingsMax marginal deviationHARD statusValidation rows
55540.00%pass_exact62

Run files

FileBytesKind
assignment_diagnostics.json809file
build_manifest.json4,697file
constraint_residuals.json3,462file
distribution_diagnostics.json17,060file
dwelling_building_diagnostics.json23,040file
geography_quality_tiers.json6,300file
hidden_population_overlays.unavailable.json1,850file
household_diagnostics.json736file
model_notes.md2,249file
source_provenance.json36,546file
synthetic_building_assignments.parquet3,763file
synthetic_dwellings.parquet2,490file
synthetic_households.parquet2,795file
synthetic_persons.parquet5,577file
unavailable.json1,883file
uncertainty_summary.json17,359file
work_school_assignments.unavailable.json870file

Datasets and distributions

Lists come from the latest run bundle: source_provenance.json, distribution_diagnostics.json, and build_manifest.json.

Summary

Datasets used7
Distributions available39
Constraints/distributions used in synthesis27
Constraint typesFIRM: 7, GUIDE: 18, HARD: 3, SOFT: 11
Dataset variantscurrent: 1, literature: 11, robust: 27
Finest-geography statusconstrained: 27, measured: 1, modelled: 11

Source gaps

  • The current Netherlands live path is sample-download capable, but it is still a probe-and-normalization bridge rather than a full-country CBS extraction pipeline.
  • Open BAG/PDOK building geometry and dwelling records are still handled through the seeded slice rather than a full bulk XML-GML ingestion path.
  • Occupation and industry detail still need deeper registry and model integration beyond the current CBS demographic bridge.

Datasets used

Dataset/source ID
NL_BAG_buildings
NL_CBS_BUURT_POPULATION
NL_CBS_DEMOGRAPHICS_MARITAL
NL_CBS_HOUSEHOLDS
NL_CBS_INCOME
NL_CBS_ORIGIN
NL_PDOK_buurt_boundaries

Best source by distribution family

Distribution familyDataset/source ID
D01_demographics_finestNL_CBS_BUURT_POPULATION
D02_marital_statusNL_CBS_DEMOGRAPHICS_MARITAL
D12_household_typeNL_CBS_HOUSEHOLDS
building_stockNL_BAG_buildings
geography_boundariesNL_PDOK_buurt_boundaries
incomeNL_CBS_INCOME
origin_distributionNL_CBS_ORIGIN

Available distributions / priors in registry

SpecLabelTypeGeoStatusVariantConfidenceData URI
C01_education_occupation_couplingEducation-occupation coupling strengthGUIDEnationalmodelledliterature0.64data/literature/seeded_occupation_priors.yaml
C02_assortative_mating_educationAssortative mating by educationGUIDEmunicipalitymodelledliterature0.65data/literature/seeded_occupation_priors.yaml
C03_assortative_mating_ageAssortative mating by ageGUIDEmunicipalitymodelledliterature0.72data/literature/seeded_occupation_priors.yaml
C04_assortative_mating_originAssortative mating by originGUIDEmunicipalitymodelledliterature0.66data/literature/seeded_occupation_priors.yaml
C05_spatial_sorting_educationSpatial sorting by educationGUIDEnationalmodelledliterature0.74data/literature/seeded_occupation_priors.yaml
C06_spatial_sorting_incomeSpatial sorting by incomeGUIDEnationalmodelledliterature0.74data/literature/seeded_occupation_priors.yaml
C07_spatial_sorting_originSpatial sorting by originGUIDEnationalmodelledliterature0.76data/literature/seeded_occupation_priors.yaml
C08_intergenerational_income_elasticityIntergenerational income elasticityGUIDEnationalmodelledliterature0.62data/literature/seeded_occupation_priors.yaml
C09_intergenerational_occupation_transmissionIntergenerational occupation transmissionGUIDEnationalmodelledliterature0.62data/literature/seeded_occupation_priors.yaml
C10_commuting_mode_distanceCommuting mode × distance × occupation × regionGUIDEmunicipalitymodelledliterature0.68data/literature/seeded_occupation_priors.yaml
C11_health_age_sex_educationHealth × age × sex × educationGUIDEnationalmodelledliterature0.66data/literature/seeded_occupation_priors.yaml
D01_age_sex_nuts3Age × sex at NUTS-3HARDNUTS-3constrainedrobust0.74docs/wiki/compiled/D01_age_sex_nuts3.md
D01_census_age_sex_nuts3Census age × sex at NUTS-3HARDNUTS-3constrainedrobust0.74docs/wiki/compiled/D01_census_age_sex_nuts3.md
D01_nl_buurtAge × sex at buurt levelHARDbuurtmeasuredrobust0.99docs/wiki/compiled/D01_nl_buurt.md
D02_marital_nuts3Marital status × age × sex at NUTS-3FIRMNUTS-3constrainedrobust0.73docs/wiki/compiled/D02_marital_nuts3.md
D03_origin_age_sexOrigin group × age × sexFIRMNUTS-3constrainedrobust0.73docs/wiki/compiled/D03_origin_age_sex.md
D04_religion_age_sex_regionReligion × age × sex × regionGUIDENUTS-3constrainedrobust0.71docs/wiki/compiled/D04_religion_age_sex_region.md
D05_census_education_nuts3Census education at NUTS-3FIRMNUTS-3constrainedrobust0.73docs/wiki/compiled/D05_census_education_nuts3.md
D05_education_nuts2Education at NUTS-2FIRMNUTS-2constrainedcurrent0.7docs/wiki/compiled/D05_education_nuts2.md
D06_employment_age_sex_educationEmployment status × age × sex × educationFIRMunknownconstrainedrobust0.73docs/wiki/compiled/D06_employment_age_sex_education.md
D07_occupation_isco3Occupation ISCO-3 distributionSOFTunknownconstrainedrobust0.71docs/wiki/compiled/D07_occupation_isco3.md
D08_occupation_educationOccupation × educationSOFTunknownconstrainedrobust0.71docs/wiki/compiled/D08_occupation_education.md
D09_industry_nace2Industry NACE-2 distributionSOFTunknownconstrainedrobust0.71docs/wiki/compiled/D09_industry_nace2.md
D10_income_education_occupationIncome × education × occupationSOFTunknownconstrainedrobust0.71docs/wiki/compiled/D10_income_education_occupation.md
D11_income_household_type_regionIncome × household type × regionSOFTNUTS-3constrainedrobust0.71docs/wiki/compiled/D11_income_household_type_region.md
D12_household_type_size_regionHousehold type × size × regionFIRMNUTS-3constrainedrobust0.73docs/wiki/compiled/D12_household_type_size_region.md
D13_children_mother_age_educationChildren × mother age × educationSOFTNUTS-3constrainedrobust0.71docs/wiki/compiled/D13_children_mother_age_education.md
D14_partner_age_gap_homogamyPartner age gap × homogamySOFTNUTS-3constrainedrobust0.71docs/wiki/compiled/D14_partner_age_gap_homogamy.md
D15_coresidence_structureCo-residence structureSOFTNUTS-3constrainedrobust0.71docs/wiki/compiled/D15_coresidence_structure.md
D16_household_income_type_regionHousehold income × type × regionSOFTNUTS-3constrainedrobust0.71docs/wiki/compiled/D16_household_income_type_region.md
D17_education_mobilityEducation mobilityGUIDEunknownconstrainedrobust0.71docs/wiki/compiled/D17_education_mobility.md
D18_occupation_given_educationOccupation | educationSOFTunknownconstrainedrobust0.71docs/wiki/compiled/D18_occupation_given_education.md
D19_employment_given_demographicsEmployment | demographicsSOFTunknownconstrainedrobust0.71docs/wiki/compiled/D19_employment_given_demographics.md
D20_birth_intervalsBirth intervalsGUIDEunknownconstrainedrobust0.71docs/wiki/compiled/D20_birth_intervals.md
D21_age_first_birthAge at first birth × education × cohortGUIDEunknownconstrainedrobust0.71docs/wiki/compiled/D21_age_first_birth.md
D22_age_leaving_homeAge leaving homeGUIDEunknownconstrainedrobust0.71docs/wiki/compiled/D22_age_leaving_home.md
D23_divorce_duration_children_educationDivorce × duration × children × educationGUIDENUTS-3constrainedrobust0.71docs/wiki/compiled/D23_divorce_duration_children_education.md
D24_age_marriage_sex_educationAge at marriage × sex × educationGUIDENUTS-3constrainedrobust0.71docs/wiki/compiled/D24_age_marriage_sex_education.md
D25_internal_migrationInternal migrationFIRMunknownconstrainedrobust0.73docs/wiki/compiled/D25_internal_migration.md

Constraints/distributions used in synthesis manifest

Constraint or distribution ID
CORR_OCC_EMPLOYMENT
D01
D12
EMPLOYMENT_CODE_LINK
FIRM
GUIDE
HARD
HARMONIZATION
HH_CHILD_ADULT
HH_COUPLE_TWO_ADULTS
HH_SINGLE_SIZE_ONE
HH_SIZE_PLAUSIBLE
HMN_EDUCATION
HMN_HOUSEHOLD_TYPE
HMN_INDUSTRY
HMN_MARITAL
HMN_OCCUPATION
HMN_ORIGIN
HMN_SEX
INFORMATIONAL
MODEL_FALLBACK_RATE
SPATIAL
SPT_BUILDING_COORDS
SPT_DWELLING_BUILDING_REF
SPT_HH_DWELLING_REF
STRUCTURAL
XCN_COMPARABILITY

model_notes.md

# NL population review bundle — cycle 1

Run ID: `nl_population_review_cycle1_fa78aabf_seed420987`
Bundle path: `/home/synthestat/output/runs/NL/nl_population_review_cycle1_fa78aabf_seed420987`
Created at: 2026-05-19T16:40:17Z
Release mode: internal research review.

## What this bundle is

This is the best current NL review bundle that can be produced from the existing Synthestat source/code layer without fabricating precision. It packages the seeded Netherlands population slice: 5 synthetic persons in 5 households, linked to 5 dwellings and 4 BAG/PDOK-seeded review buildings across 3 buurt-style test zones (BU_NL_TEST_001, BU_NL_TEST_002, BU_NL_TEST_003).

## HARD residual status

HARD constraints: PASS exact; no HARD residual rows failed.

Validation summary: {'pass': 59, 'skip': 3} across 62 rows. Warning/skip rows are preserved in `constraint_residuals.json`; no constraint relaxation was performed for this review bundle.

## Uncertainty and modelled layers

Uncertainty/provenance are first-class outputs. Registry/modelled inputs are listed in `distribution_diagnostics.json`, `uncertainty_summary.json`, and `source_provenance.json`. Hidden populations are explicitly unavailable because the current NL path lacks separate uncertainty-aware small-area sources. Work/school/facility assignments are also unavailable; the bundle does not infer them from weak evidence.

## Quality caveats for reviewer

- Scope is seeded/internal, not nationwide NL 1:1 synthesis.
- Current finest supported geography is seeded buurt-style test zones, not all Dutch neighbourhoods.
- Building/dwelling realism uses current BAG/PDOK seeded review outputs and remains short of full national BAG-backed production assignment.
- Occupation/industry at fine geography are modelled unless measured and must remain flagged with uncertainty/provenance.
- Hidden populations and work/school assignments are unavailable rather than fabricated.

## Expected routing

The bundle is contract-complete for synth-reviewer inspection. Because scope is intentionally seeded and several layers are unavailable, likely routing should be either EVIDENCE_EXHAUSTED_HUMAN_REVIEW or MODEL_IMPROVEMENT_EXHAUSTED_HUMAN_REVIEW unless reviewer finds a contract violation.

build_manifest.json

{
  "assignment_scope": {
    "dwelling_building": "available_seeded",
    "facility": "unavailable",
    "school": "unavailable",
    "work": "unavailable"
  },
  "assignment_scope_summary": "seeded dwelling/building only; work/school unavailable",
  "classification_crosswalk_versions": {
    "education": "ISCED-2011 seeded mapping",
    "industry": "NACE Rev.2 seeded/modelled mapping",
    "occupation": "ISCO-08 seeded/modelled fallback where sparse"
  },
  "constraints_relaxed": [],
  "constraints_used": [
    "CORR_OCC_EMPLOYMENT",
    "D01",
    "D12",
    "EMPLOYMENT_CODE_LINK",
    "FIRM",
    "GUIDE",
    "HARD",
    "HARMONIZATION",
    "HH_CHILD_ADULT",
    "HH_COUPLE_TWO_ADULTS",
    "HH_SINGLE_SIZE_ONE",
    "HH_SIZE_PLAUSIBLE",
    "HMN_EDUCATION",
    "HMN_HOUSEHOLD_TYPE",
    "HMN_INDUSTRY",
    "HMN_MARITAL",
    "HMN_OCCUPATION",
    "HMN_ORIGIN",
    "HMN_SEX",
    "INFORMATIONAL",
    "MODEL_FALLBACK_RATE",
    "SPATIAL",
    "SPT_BUILDING_COORDS",
    "SPT_DWELLING_BUILDING_REF",
    "SPT_HH_DWELLING_REF",
    "STRUCTURAL",
    "XCN_COMPARABILITY"
  ],
  "contract_files": [
    "synthetic_persons.parquet",
    "synthetic_households.parquet",
    "synthetic_dwellings.parquet",
    "synthetic_building_assignments.parquet",
    "hidden_population_overlays.unavailable.json",
    "work_school_assignments.unavailable.json",
    "build_manifest.json",
    "constraint_residuals.json",
    "distribution_diagnostics.json",
    "household_diagnostics.json",
    "dwelling_building_diagnostics.json",
    "assignment_diagnostics.json",
    "geography_quality_tiers.json",
    "uncertainty_summary.json",
    "source_provenance.json",
    "model_notes.md",
    "unavailable.json"
  ],
  "country": "NL",
  "created_at": "2026-05-19T16:40:17Z",
  "geography_version": {
    "seeded_test_zones": [
      "BU_NL_TEST_001",
      "BU_NL_TEST_002",
      "BU_NL_TEST_003"
    ],
    "target": "NL_BUURT_SEEDED_REVIEW"
  },
  "git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba-dirty",
  "git_dirty": true,
  "hard_constraint_status": "pass_exact",
  "hidden_population_scope": {
    "homelessness": {
      "reason": "No integrated NL small-area homelessness distribution with age/sex/household uncertainty bounds is wired into the current synthesis path.",
      "status": "unavailable"
    },
    "institutional_populations": {
      "reason": "No group-quarter/institution population layer is integrated for NL in the current seeded path.",
      "status": "unavailable"
    },
    "refugees_asylum_seekers": {
      "reason": "No separate bounded municipality/neighbourhood refugee/asylum stock overlay is integrated in the current bundle inputs.",
      "status": "unavailable"
    },
    "students": {
      "reason": "Education/employment attributes exist only as modelled person fields; no separate student-location or institution overlay/assignment layer is available.",
      "status": "unavailable_overlay"
    },
    "syrian_refugees": {
      "reason": "No NL-specific small-area measured source with bounds is integrated; would be model-only and therefore not emitted.",
      "status": "unavailable"
    },
    "ukrainian_displaced_people": {
      "reason": "Policy-relevant group, but no separate uncertainty-aware NL small-area overlay source is promoted into the synthesis layer.",
      "status": "unavailable"
    },
    "undocumented_seasonal_populations": {
      "reason": "No measured distribution with defensible bounds is integrated in current repo inputs.",
      "status": "unavailable"
    }
  },
  "hidden_population_scope_summary": "unavailable overlays only; no de jure constraint rewrite",
  "known_limitations": [
    "Small seeded NL review slice only: 3 buurt-style test zones, 5 persons/households; not nationwide 1:1 Netherlands synthesis.",
    "BAG/PDOK building/dwelling layer is review-visible seeded/normalized output, not full national runtime BAG-backed assignment.",
    "Hidden populations and work/school assignments unavailable rather than modelled without bounds.",
    "Fine occupation/industry/geography variables are model-driven unless measured and must remain flagged."
  ],
  "missing_inputs": [],
  "population_counts": {
    "buildings": 4,
    "dwellings": 5,
    "households": 5,
    "persons": 5
  },
  "project_root": "/home/synthestat",
  "random_seed": 420987,
  "release_mode": "internal_research_review",
  "run_id": "nl_population_review_cycle1_fa78aabf_seed420987",
  "source_catalogue_version": {
    "readiness_status": "pass",
    "registry": "output/catalogue/distribution_registry_NL.json",
    "source_inventory_report": "output/NL/source_inventory_report.json"
  },
  "zones_degraded": []
}

constraint_residuals.json

{
  "constraint_precedence": [
    "HARD",
    "FIRM",
    "SOFT",
    "GUIDE",
    "INFORMATIONAL"
  ],
  "constraint_type_counts": {
    "FIRM": 3,
    "GUIDE": 3,
    "HARD": 5,
    "HARMONIZATION": 21,
    "INFORMATIONAL": 6,
    "SPATIAL": 9,
    "STRUCTURAL": 15
  },
  "country": "NL",
  "hard_constraint_broken_rows": [],
  "hard_constraint_status": "pass_exact",
  "residual_rows_source": "output/NL/validation_report.parquet",
  "residuals_by_constraint_type": {
    "FIRM": {
      "max_abs_relative_error": 0,
      "row_count": 3,
      "status_counts": {
        "pass": 3
      },
      "tolerance_policy": "normally <=2%"
    },
    "GUIDE": {
      "max_abs_relative_error": 0,
      "row_count": 3,
      "status_counts": {
        "pass": 3
      },
      "tolerance_policy": "prior only"
    },
    "HARD": {
      "max_abs_relative_error": 0,
      "row_count": 5,
      "status_counts": {
        "pass": 5
      },
      "tolerance_policy": "exact"
    },
    "HARMONIZATION": {
      "max_abs_relative_error": 0,
      "row_count": 21,
      "status_counts": {
        "pass": 21
      },
      "tolerance_policy": "structural/harmonization check; see validation rows"
    },
    "INFORMATIONAL": {
      "max_abs_relative_error": 0,
      "row_count": 6,
      "status_counts": {
        "pass": 3,
        "skip": 3
      },
      "tolerance_policy": "not constraining"
    },
    "SPATIAL": {
      "max_abs_relative_error": 0,
      "row_count": 9,
      "status_counts": {
        "pass": 9
      },
      "tolerance_policy": "structural/harmonization check; see validation rows"
    },
    "STRUCTURAL": {
      "max_abs_relative_error": 0,
      "row_count": 15,
      "status_counts": {
        "pass": 15
      },
      "tolerance_policy": "structural/harmonization check; see validation rows"
    }
  },
  "run_id": "nl_population_review_cycle1_fa78aabf_seed420987",
  "skip_rows": [
    {
      "check_group": "cross_country",
      "confidence": 0.0,
      "constraint_type": "INFORMATIONAL",
      "country": "NL",
      "distribution_id": "XCN_COMPARABILITY",
      "message": "cross-country comparability requires 2+ countries",
      "pooling_level": "cross_country",
      "relative_error": 0.0,
      "severity": "informational",
      "status": "skip",
      "synthetic_value": 0.0,
      "target_value": 0.0,
      "zone_code": "BU_NL_TEST_001"
    },
    {
      "check_group": "cross_country",
      "confidence": 0.0,
      "constraint_type": "INFORMATIONAL",
      "country": "NL",
      "distribution_id": "XCN_COMPARABILITY",
      "message": "cross-country comparability requires 2+ countries",
      "pooling_level": "cross_country",
      "relative_error": 0.0,
      "severity": "informational",
      "status": "skip",
      "synthetic_value": 0.0,
      "target_value": 0.0,
      "zone_code": "BU_NL_TEST_002"
    },
    {
      "check_group": "cross_country",
      "confidence": 0.0,
      "constraint_type": "INFORMATIONAL",
      "country": "NL",
      "distribution_id": "XCN_COMPARABILITY",
      "message": "cross-country comparability requires 2+ countries",
      "pooling_level": "cross_country",
      "relative_error": 0.0,
      "severity": "informational",
      "status": "skip",
      "synthetic_value": 0.0,
      "target_value": 0.0,
      "zone_code": "BU_NL_TEST_003"
    }
  ],
  "status_counts": {
    "pass": 59,
    "skip": 3
  },
  "validation_row_count": 62,
  "warn_rows": []
}

household_diagnostics.json

{
  "country": "NL",
  "family_composition_status": "weak_seeded_modelled",
  "household_count": 5,
  "household_role_counts": {
    "reference": 5
  },
  "household_size_counts": {
    "1": 5
  },
  "household_type_counts": {
    "HH_SINGLE_M": 2,
    "HH_SINGLE_Y": 3
  },
  "households_without_dwelling": [],
  "notes": [
    "Seeded NL review slice currently has 5 persons/households across 3 test buurten; family-composition review should request richer measured household microstructure before approving broad use."
  ],
  "parent_child_age_gap_status": "not_evaluable_no_child_households_in_seeded_NL_slice",
  "person_count": 5,
  "persons_without_household": [],
  "run_id": "nl_population_review_cycle1_fa78aabf_seed420987"
}

dwelling_building_diagnostics.json

{
  "assignment_counts": {
    "linked_bag_pdok_seeded_review_layer": 5
  },
  "bag_pdok_normalization_report": {
    "artifact_count": 3,
    "artifacts": {
      "building_report_path": "output/NL/building_inventory_report.json",
      "buildings_path": "output/NL/buildings.parquet",
      "dwellings_path": "output/NL/dwellings.parquet"
    },
    "bag_raw_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/NL_BAG_BUILDINGS_RAW/bag_seed.json",
    "bag_raw_resolution": "current_raw_packet",
    "boundary_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/NL_PDOK_BUURT_BOUNDARIES_RAW/pdok_buurt_seed.geojson",
    "boundary_resolution": "current_raw_packet",
    "bridge_alignment": "current_raw_packet",
    "bridge_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
    "country": "NL",
    "linked_asset_count": 4,
    "linked_asset_count_by_source": {
      "NL_BAG_ATOM_FEED": 2,
      "NL_PDOK_BUURT_2024_ATOM_INDEX": 1,
      "NL_PDOK_BUURT_2024_GEOPACKAGE_FEED": 1
    },
    "linked_asset_total_bytes": 11728170437,
    "linked_asset_urls": [
      "https://service.pdok.nl/kadaster/bag/atom/downloads/bag-light.gpkg",
      "https://service.pdok.nl/kadaster/bag/atom/downloads/lvbag-extract-nl.zip",
      "https://service.pdok.nl/cbs/wijkenbuurten/2024/atom/wijk_en_buurtkaart_2024.xml",
      "https://service.pdok.nl/cbs/wijkenbuurten/2024/atom/downloads/wijkenbuurten_2024.gpkg"
    ],
    "manifest_raw_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
    "normalization_mode": "raw_packet_seed_bridge",
    "notes": [
      "This INFRA-19 bridge normalizes the current BAG/PDOK raw-manifest surface into standard NL building outputs.",
      "Until heavy BAG and PDOK assets are downloaded and parsed, the command resolves the nearest staged seed/raw packet and records that bridge explicitly.",
      "The standard NL output contract is preserved so country-slice and release-review commands can consume the result without ad hoc path changes."
    ],
    "output_dir": "output/NL",
    "promoted_boundary_summary": null,
    "raw_manifest_path": "output/NL/bag_pdok_raw_manifest.json",
    "raw_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
    "run_label": "2026-04-14_cto_pdok_geopackage_stage",
    "staged_asset_parse_summary": {
      "assets": [
        {
          "archive_entry_count": 12,
          "delivery_document": {
            "technical_date": "2026-04-08"
          },
          "media_type": "application/zip",
          "object_archives": [
            {
              "archive_name": "9999LIG08042026.zip",
              "member_count": 2,
              "object_code": "LIG"
            },
            {
              "archive_name": "9999NUM08042026.zip",
              "object_code": "NUM"
            },
            {
              "archive_name": "9999OPR08042026.zip",
              "member_count": 36,
              "object_code": "OPR"
            },
            {
              "archive_name": "9999PND08042026.zip",
              "object_code": "PND"
            },
            {
              "archive_name": "9999STA08042026.zip",
              "member_count": 9,
              "object_code": "STA"
            },
            {
              "archive_name": "9999VBO08042026.zip",
              "object_code": "VBO"
            },
            {
              "archive_name": "9999WPL08042026.zip",
              "member_count": 1,
              "object_code": "WPL"
            },
            {
              "archive_name": "GEM-WPL-RELATIE-08042026.zip",
              "member_count": 1,
              "object_code": "WPL"
            }
          ],
          "parse_status": "parsed_bag_extract_archive",
          "source_id": "NL_BAG_ATOM_FEED",
          "staged_artifact_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/bag/linked_assets/nl_bag_atom_feed/nl_bag_atom_feed_bag_(epsg:28992)_zip_archief_-_lvbag-extract-nl.zip.zip",
          "title": "BAG (EPSG:28992) Zip archief - lvbag-extract-nl.zip"
        }
      ],
      "parsed_asset_count": 1,
      "parsed_source_ids": [
        "NL_BAG_ATOM_FEED"
      ]
    },
    "staged_asset_promotion_summary": {
      "candidate_count": 0,
      "candidates": [],
      "promotion_blockers": [],
      "promotion_ready": false,
      "runtime_promotion_ready": false
    }
  },
  "building_count": 4,
  "building_inventory_report": {
    "artifacts": {
      "buildings_path": "/home/synthestat/output/NL/buildings.parquet",
      "dwellings_path": "/home/synthestat/output/NL/dwellings.parquet"
    },
    "bag_pdok_raw_summary": {
      "artifact_count": 3,
      "linked_asset_count": 4,
      "linked_asset_count_by_source": {
        "NL_BAG_ATOM_FEED": 2,
        "NL_PDOK_BUURT_2024_ATOM_INDEX": 1,
        "NL_PDOK_BUURT_2024_GEOPACKAGE_FEED": 1
      },
      "linked_asset_total_bytes": 11728170437,
      "linked_asset_urls": [
        "https://service.pdok.nl/kadaster/bag/atom/downloads/bag-light.gpkg",
        "https://service.pdok.nl/kadaster/bag/atom/downloads/lvbag-extract-nl.zip",
        "https://service.pdok.nl/cbs/wijkenbuurten/2024/atom/wijk_en_buurtkaart_2024.xml",
        "https://service.pdok.nl/cbs/wijkenbuurten/2024/atom/downloads/wijkenbuurten_2024.gpkg"
      ]
    },
    "boundary_path": "/home/synthestat/data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/NL_PDOK_BUURT_BOUNDARIES_RAW/pdok_buurt_seed.geojson",
    "bridge_alignment": "current_raw_packet",
    "bridge_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
    "building_count": 4,
    "country": "NL",
    "dwelling_count": 5,
    "dwelling_model": {
      "capacity_floor": 5,
      "inferred_dwelling_count": 0,
      "mode": "observed_bag_objects_only",
      "notes": [
        "This bridge keeps the seeded BAG fixture's observed verblijfsobjecten, ligplaatsen, and standplaatsen as the full NL dwelling path.",
        "No heuristic dwelling inference is applied in the current BAG/PDOK bridge; dwelling_count is a floor from observed BAG objects only."
      ],
      "observed_dwelling_count": 5,
      "special_dwelling_count": 2
    },
    "field_gap_counts": {
      "missing_construction_year_count": 2,
      "missing_floor_area_count": 0,
      "missing_storeys_count": 2,
      "missing_zone_code_count": 0
    },
    "geometry_summary": {
      "assigned_zone_count": 4,
      "missing_geometry_count": 0,
      "point_geometry_count": 2,
      "polygon_geometry_count": 2,
      "unassigned_zone_count": 0
    },
    "normalization_mode": "raw_packet_seed_bridge",
    "quality_tier": "B1",
    "raw_manifest_path": "output/NL/bag_pdok_raw_manifest.json",
    "raw_manifest_run_label": "2026-04-14_cto_pdok_geopackage_stage",
    "raw_path": "/home/synthestat/data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/NL_BAG_BUILDINGS_RAW/bag_seed.json",
    "source_bridge": {
      "bag_raw_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/NL_BAG_BUILDINGS_RAW/bag_seed.json",
      "bag_raw_resolution": "current_raw_packet",
      "bag_raw_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
      "boundary_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/NL_PDOK_BUURT_BOUNDARIES_RAW/pdok_buurt_seed.geojson",
      "boundary_resolution": "current_raw_packet",
      "boundary_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage"
    },
    "special_dwelling_counts": {
      "boat": 1,
      "mobile_home": 1
    },
    "staged_asset_parse_summary": {
      "assets": [
        {
          "archive_entry_count": 12,
          "delivery_document": {
            "technical_date": "2026-04-08"
          },
          "media_type": "application/zip",
          "object_archives": [
            {
              "archive_name": "9999LIG08042026.zip",
              "member_count": 2,
              "object_code": "LIG"
            },
            {
              "archive_name": "9999NUM08042026.zip",
              "object_code": "NUM"
            },
            {
              "archive_name": "9999OPR08042026.zip",
              "member_count": 36,
              "object_code": "OPR"
            },
            {
              "archive_name": "9999PND08042026.zip",
              "object_code": "PND"
            },
            {
              "archive_name": "9999STA08042026.zip",
              "member_count": 9,
              "object_code": "STA"
            },
            {
              "archive_name": "9999VBO08042026.zip",
              "object_code": "VBO"
            },
            {
              "archive_name": "9999WPL08042026.zip",
              "member_count": 1,
              "object_code": "WPL"
            },
            {
              "archive_name": "GEM-WPL-RELATIE-08042026.zip",
              "member_count": 1,
              "object_code": "WPL"
            }
          ],
          "parse_status": "parsed_bag_extract_archive",
          "source_id": "NL_BAG_ATOM_FEED",
          "staged_artifact_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/bag/linked_assets/nl_bag_atom_feed/nl_bag_atom_feed_bag_(epsg:28992)_zip_archief_-_lvbag-extract-nl.zip.zip",
          "title": "BAG (EPSG:28992) Zip archief - lvbag-extract-nl.zip"
        }
      ],
      "parsed_asset_count": 1,
      "parsed_source_ids": [
        "NL_BAG_ATOM_FEED"
      ]
    },
    "unresolved_field_gaps": [
      "missing_construction_year_count",
      "missing_storeys_count"
    ],
    "zone_counts": {
      "BU_NL_TEST_001": 1,
      "BU_NL_TEST_002": 1,
      "BU_NL_TEST_003": 2
    }
  },
  "building_quality_tier_counts": {
    "B1": 4
  },
  "caveats": [
    "BAG/PDOK raw assets are staged and parsed in reports, but the current population review output remains a seeded/test-zone slice rather than national BAG-backed 1:1 NL assignment."
  ],
  "country": "NL",
  "dwelling_count": 5,
  "dwelling_status_counts": {
    "observed": 5
  },
  "household_count": 5,
  "real_building_status": "seeded BAG/PDOK-normalized review layer; not full national BAG runtime production assignment",
  "release_review": {
    "artifacts": {
      "bag_pdok_normalization": {
        "artifact_count": 3,
        "bag_raw_resolution": "current_raw_packet",
        "boundary_resolution": "current_raw_packet",
        "bridge_alignment": "current_raw_packet",
        "bridge_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
        "linked_asset_count": 4,
        "linked_asset_count_by_source": {
          "NL_BAG_ATOM_FEED": 2,
          "NL_PDOK_BUURT_2024_ATOM_INDEX": 1,
          "NL_PDOK_BUURT_2024_GEOPACKAGE_FEED": 1
        },
        "linked_asset_total_bytes": 11728170437,
        "manifest_raw_root": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage",
        "normalization_mode": "raw_packet_seed_bridge",
        "raw_manifest_path": "output/NL/bag_pdok_raw_manifest.json",
        "run_label": "2026-04-14_cto_pdok_geopackage_stage",
        "staged_asset_parse_summary": {
          "assets": [
            {
              "media_type": "application/zip",
              "parse_status": "parsed_bag_extract_archive",
              "source_id": "NL_BAG_ATOM_FEED",
              "staged_artifact_path": "data/ingestion/nl/bag_pdok_raw/2026-04-14_cto_pdok_geopackage_stage/bag/linked_assets/nl_bag_atom_feed/nl_bag_atom_feed_bag_(epsg:28992)_zip_archief_-_lvbag-extract-nl.zip.zip",
              "title": "BAG (EPSG:28992) Zip archief - lvbag-extract-nl.zip"
            }
          ],
          "parsed_asset_count": 1,
          "parsed_source_ids": [
            "NL_BAG_ATOM_FEED"
          ]
        },
        "staged_asset_promotion_summary": {
          "candidate_count": 0,
          "promotion_ready": false,
          "runtime

… truncated after 12,000 characters …

distribution_diagnostics.json

{
  "blocking_issues": [],
  "by_constraint_type": {
    "FIRM": 7,
    "GUIDE": 18,
    "HARD": 3,
    "SOFT": 11
  },
  "by_dataset_variant": {
    "current": 1,
    "literature": 11,
    "robust": 27
  },
  "by_finest_geography_status": {
    "constrained": 27,
    "measured": 1,
    "modelled": 11
  },
  "confidence_below_0_7": [
    {
      "catalogue_id": "literature:nl-c01_education_occupation_coupling",
      "confidence": 0.64,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "37dd178fbfc096717d310f69212adab59f44c786ab0a7ba3a619cd14a1ad25a8",
      "spec_id": "C01_education_occupation_coupling",
      "spec_label": "Education-occupation coupling strength",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.17,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c02_assortative_mating_education",
      "confidence": 0.65,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "eaee1a327700e2d610d66250874c4a02384c91acf0978dc0da7068f160c72ccb",
      "spec_id": "C02_assortative_mating_education",
      "spec_label": "Assortative mating by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c04_assortative_mating_origin",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "28af2b98be831deada16d0cb59fff8c508690bec693dba1d2ada30ed79847f7c",
      "spec_id": "C04_assortative_mating_origin",
      "spec_label": "Assortative mating by origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c08_intergenerational_income_elasticity",
      "confidence": 0.62,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "3d22c15ad14b099d588d92509ac6c1cc093b93030886566dfb5515832921485c",
      "spec_id": "C08_intergenerational_income_elasticity",
      "spec_label": "Intergenerational income elasticity",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.19,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c09_intergenerational_occupation_transmission",
      "confidence": 0.62,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "442742abe9c98b9e140543e204024034e0af7af48f434f22ce06c293940cb417",
      "spec_id": "C09_intergenerational_occupation_transmission",
      "spec_label": "Intergenerational occupation transmission",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.19,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c10_commuting_mode_distance",
      "confidence": 0.68,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "2015fab2a394a190c86a9f6689f241a0cc479afe8e92a88dd282ecfe5b3a669b",
      "spec_id": "C10_commuting_mode_distance",
      "spec_label": "Commuting mode × distance × occupation × region",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.15,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c11_health_age_sex_education",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "576119788fbe954a5198139e9bd5d75211297f26096080fb89a111fc0f12c1df",
      "spec_id": "C11_health_age_sex_education",
      "spec_label": "Health × age × sex × education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_regression"
      }
    }
  ],
  "confidence_below_0_7_count": 7,
  "country": "NL",
  "coverage_path": "output/catalogue/distribution_coverage_NL.json",
  "coverage_summary": {
    "country": "NL",
    "covered_count": 39,
    "missing_count": 0,
    "readiness_status": "pass",
    "required_count": 39,
    "usable_count": 39,
    "usable_ratio": 1.0
  },
  "modelled_or_transfer_entries": [
    {
      "catalogue_id": "literature:nl-c01_education_occupation_coupling",
      "confidence": 0.64,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "37dd178fbfc096717d310f69212adab59f44c786ab0a7ba3a619cd14a1ad25a8",
      "spec_id": "C01_education_occupation_coupling",
      "spec_label": "Education-occupation coupling strength",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.17,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c02_assortative_mating_education",
      "confidence": 0.65,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "eaee1a327700e2d610d66250874c4a02384c91acf0978dc0da7068f160c72ccb",
      "spec_id": "C02_assortative_mating_education",
      "spec_label": "Assortative mating by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c03_assortative_mating_age",
      "confidence": 0.72,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "3eb83fc2d668330c0741a9ecbc79396899723ab82c36e6ea65145422ab21298e",
      "spec_id": "C03_assortative_mating_age",
      "spec_label": "Assortative mating by age",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.11,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c04_assortative_mating_origin",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "28af2b98be831deada16d0cb59fff8c508690bec693dba1d2ada30ed79847f7c",
      "spec_id": "C04_assortative_mating_origin",
      "spec_label": "Assortative mating by origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c05_spatial_sorting_education",
      "confidence": 0.74,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "81919503e223cee02fbe214f9f58eee6beea943d8f4c47532dfb1f637823c718",
      "spec_id": "C05_spatial_sorting_education",
      "spec_label": "Spatial sorting by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.1,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c06_spatial_sorting_income",
      "confidence": 0.74,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "67a18b48874fd2b61c8c75faae79efcac77b098d9

… truncated after 12,000 characters …

uncertainty_summary.json

{
  "country": "NL",
  "hidden_population_uncertainty_status": "unavailable; no overlays emitted because bounds/evidence are missing in current layer",
  "input_uncertainty_records": [
    {
      "catalogue_id": "literature:nl-c01_education_occupation_coupling",
      "confidence": 0.64,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C01_education_occupation_coupling",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.17,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c02_assortative_mating_education",
      "confidence": 0.65,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C02_assortative_mating_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c03_assortative_mating_age",
      "confidence": 0.72,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C03_assortative_mating_age",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.11,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c04_assortative_mating_origin",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C04_assortative_mating_origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c05_spatial_sorting_education",
      "confidence": 0.74,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C05_spatial_sorting_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.1,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c06_spatial_sorting_income",
      "confidence": 0.74,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C06_spatial_sorting_income",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.1,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c07_spatial_sorting_origin",
      "confidence": 0.76,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C07_spatial_sorting_origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.09,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c08_intergenerational_income_elasticity",
      "confidence": 0.62,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C08_intergenerational_income_elasticity",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.19,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c09_intergenerational_occupation_transmission",
      "confidence": 0.62,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C09_intergenerational_occupation_transmission",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.19,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c10_commuting_mode_distance",
      "confidence": 0.68,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C10_commuting_mode_distance",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.15,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c11_health_age_sex_education",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "finest_geography_status": "modelled",
      "spec_id": "C11_health_age_sex_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "D01_age_sex_nuts3",
      "confidence": 0.74,
      "constraint_type": "HARD",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D01_age_sex_nuts3",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.26,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D01_census_age_sex_nuts3",
      "confidence": 0.74,
      "constraint_type": "HARD",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D01_census_age_sex_nuts3",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.26,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D01_nl_buurt",
      "confidence": 0.99,
      "constraint_type": "HARD",
      "dataset_variant": "robust",
      "finest_geography_status": "measured",
      "spec_id": "D01_nl_buurt",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.01,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D02_marital_nuts3",
      "confidence": 0.73,
      "constraint_type": "FIRM",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D02_marital_nuts3",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.27,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D03_origin_age_sex",
      "confidence": 0.73,
      "constraint_type": "FIRM",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D03_origin_age_sex",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.27,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D04_religion_age_sex_region",
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D04_religion_age_sex_region",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D05_census_education_nuts3",
      "confidence": 0.73,
      "constraint_type": "FIRM",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D05_census_education_nuts3",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.27,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D05_education_nuts2",
      "confidence": 0.7,
      "constraint_type": "FIRM",
      "dataset_variant": "current",
      "finest_geography_status": "constrained",
      "spec_id": "D05_education_nuts2",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.3,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D06_employment_age_sex_education",
      "confidence": 0.73,
      "constraint_type": "FIRM",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D06_employment_age_sex_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.27,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D07_occupation_isco3",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D07_occupation_isco3",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D08_occupation_education",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D08_occupation_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D09_industry_nace2",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D09_industry_nace2",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D10_income_education_occupation",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D10_income_education_occupation",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D11_income_household_type_region",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D11_income_household_type_region",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D12_household_type_size_region",
      "confidence": 0.73,
      "constraint_type": "FIRM",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D12_household_type_size_region",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.27,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D13_children_mother_age_education",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D13_children_mother_age_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D14_partner_age_gap_homogamy",
      "confidence": 0.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robust",
      "finest_geography_status": "constrained",
      "spec_id": "D14_partner_age_gap_homogamy",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "catalogue_id": "D15_coresidence_structure",
      "confidence": 0

… truncated after 12,000 characters …

source_provenance.json

{
  "best_distribution_sources": {
    "D01_demographics_finest": "NL_CBS_BUURT_POPULATION",
    "D02_marital_status": "NL_CBS_DEMOGRAPHICS_MARITAL",
    "D12_household_type": "NL_CBS_HOUSEHOLDS",
    "building_stock": "NL_BAG_buildings",
    "geography_boundaries": "NL_PDOK_buurt_boundaries",
    "income": "NL_CBS_INCOME",
    "origin_distribution": "NL_CBS_ORIGIN"
  },
  "catalogue_sources": {
    "coverage": "output/catalogue/distribution_coverage_NL.json",
    "readiness": "output/catalogue/distribution_readiness_NL.json",
    "registry": "output/catalogue/distribution_registry_NL.json"
  },
  "country": "NL",
  "created_at": "2026-05-19T16:40:17Z",
  "geography_levels": [
    "NUTS-2",
    "NUTS-3",
    "buurt",
    "municipality",
    "national",
    "unknown"
  ],
  "live_download": {
    "enabled": true,
    "path": "output/NL/cbs_live_samples.json",
    "summary": {
      "base_url": "https://opendata.cbs.nl/ODataApi/odata",
      "download_count": 5,
      "downloaded_count": 5,
      "error_count": 0,
      "provider": "cbs"
    }
  },
  "live_probe": {
    "enabled": true,
    "path": "output/NL/cbs_live_probe.json",
    "summary": {
      "available_count": 5,
      "base_url": "https://opendata.cbs.nl/ODataApi/odata",
      "missing_count": 0,
      "probe_count": 5,
      "provider": "cbs"
    }
  },
  "manual_sources": [
    "NL_CBS_BUURT_POPULATION",
    "NL_CBS_DEMOGRAPHICS_MARITAL",
    "NL_CBS_HOUSEHOLDS",
    "NL_CBS_ORIGIN",
    "NL_CBS_INCOME",
    "NL_BAG_buildings",
    "NL_PDOK_buurt_boundaries"
  ],
  "quality_flags": {
    "readiness_status": "pass",
    "source_gaps": [
      "The current Netherlands live path is sample-download capable, but it is still a probe-and-normalization bridge rather than a full-country CBS extraction pipeline.",
      "Open BAG/PDOK building geometry and dwelling records are still handled through the seeded slice rather than a full bulk XML-GML ingestion path.",
      "Occupation and industry detail still need deeper registry and model integration beyond the current CBS demographic bridge."
    ],
    "warning_issues": []
  },
  "reference_periods": "See registry entries/source catalogue; bundle does not rewrite source periods.",
  "registry_entries": [
    {
      "catalogue_id": "literature:nl-c01_education_occupation_coupling",
      "confidence": 0.64,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "37dd178fbfc096717d310f69212adab59f44c786ab0a7ba3a619cd14a1ad25a8",
      "spec_id": "C01_education_occupation_coupling",
      "spec_label": "Education-occupation coupling strength",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.17,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c02_assortative_mating_education",
      "confidence": 0.65,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "eaee1a327700e2d610d66250874c4a02384c91acf0978dc0da7068f160c72ccb",
      "spec_id": "C02_assortative_mating_education",
      "spec_label": "Assortative mating by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c03_assortative_mating_age",
      "confidence": 0.72,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "3eb83fc2d668330c0741a9ecbc79396899723ab82c36e6ea65145422ab21298e",
      "spec_id": "C03_assortative_mating_age",
      "spec_label": "Assortative mating by age",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.11,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c04_assortative_mating_origin",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "28af2b98be831deada16d0cb59fff8c508690bec693dba1d2ada30ed79847f7c",
      "spec_id": "C04_assortative_mating_origin",
      "spec_label": "Assortative mating by origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c05_spatial_sorting_education",
      "confidence": 0.74,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "81919503e223cee02fbe214f9f58eee6beea943d8f4c47532dfb1f637823c718",
      "spec_id": "C05_spatial_sorting_education",
      "spec_label": "Spatial sorting by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.1,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c06_spatial_sorting_income",
      "confidence": 0.74,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "67a18b48874fd2b61c8c75faae79efcac77b098d9bf8731158987b9606f47fa8",
      "spec_id": "C06_spatial_sorting_income",
      "spec_label": "Spatial sorting by income",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.1,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c07_spatial_sorting_origin",
      "confidence": 0.76,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "fb6ec84389491d99568ac7ff76790b8aed6554eee22412ab01b23d654b2b302e",
      "spec_id": "C07_spatial_sorting_origin",
      "spec_label": "Spatial sorting by origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.09,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c08_intergenerational_income_elasticity",
      "confidence": 0.62,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "3d22c15ad14b099d588d92509ac6c1cc093b93030886566dfb5515832921485c",
      "spec_id": "C08_intergenerational_income_elasticity",
      "spec_label": "Intergenerational income elasticity",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.19,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:nl-c09_intergenerational_occupation_transmission",
      "confidence": 0.62,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "442742abe9c98b9e140543e204024034e0af7af48f434f22ce06c293940cb417",
      "spec_id": "C09_intergenerational_occupation_transmission",
      "spec_label": "Intergenerational occupation transmission",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.19,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:nl-c10_commuting_mode_distance",
      "confidence": 0.68,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "municipality",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "2015fab2a394a190c86a9f6689f241a0cc479afe8e92a88dd282ecfe5b3a669b",
      "spec_id": "C10_commuting_mode_distance",
      "spec_label": "Commuting mode × distance × occupation × region",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.15,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:nl-c11_health_age_sex_education",
      "confidence": 0.66,
      "constraint_type": "GUIDE",
      "country": "NL",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "NL_GM_CURRENT",
      "pooling_level": "national",
      "priority_weight": "low",
      "region_id": null,
      "schema_hash": "576119788fbe954a5198139e9bd5d75211297f26096080fb89a111fc0f12c1df",
      "spec_id": "C11_health_age_sex_education",
      "spec_label": "Health × age × sex × education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.16,
        "method": "literature_regression"
 

… truncated after 12,000 characters …

unavailable.json

{
  "categories": {
    "homelessness": {
      "reason": "No integrated NL small-area homelessness distribution with age/sex/household uncertainty bounds is wired into the current synthesis path.",
      "status": "unavailable"
    },
    "institutional_populations": {
      "reason": "No group-quarter/institution population layer is integrated for NL in the current seeded path.",
      "status": "unavailable"
    },
    "refugees_asylum_seekers": {
      "reason": "No separate bounded municipality/neighbourhood refugee/asylum stock overlay is integrated in the current bundle inputs.",
      "status": "unavailable"
    },
    "students": {
      "reason": "Education/employment attributes exist only as modelled person fields; no separate student-location or institution overlay/assignment layer is available.",
      "status": "unavailable_overlay"
    },
    "syrian_refugees": {
      "reason": "No NL-specific small-area measured source with bounds is integrated; would be model-only and therefore not emitted.",
      "status": "unavailable"
    },
    "ukrainian_displaced_people": {
      "reason": "Policy-relevant group, but no separate uncertainty-aware NL small-area overlay source is promoted into the synthesis layer.",
      "status": "unavailable"
    },
    "undocumented_seasonal_populations": {
      "reason": "No measured distribution with defensible bounds is integrated in current repo inputs.",
      "status": "unavailable"
    }
  },
  "country": "NL",
  "created_at": "2026-05-19T16:40:17Z",
  "files": {
    "hidden_population_overlays.parquet": "hidden_population_overlays.unavailable.json",
    "work_school_assignments.parquet": "work_school_assignments.unavailable.json"
  },
  "principle": "Unavailable/weak layers are explicit and do not alter de jure/core HARD constraints.",
  "run_id": "nl_population_review_cycle1_fa78aabf_seed420987"
}