se_population_review_cycle1_a5ad12d7_seed420987

Output status

Run files

Datasets and distributions

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

Datasets used

Best source by distribution family

Available distributions / priors in registry

Constraints/distributions used in synthesis manifest

model_notes.md

# SE population review bundle — modeller notes

Run: se_population_review_cycle1_a5ad12d7_seed420987
Created at: 2026-05-19T14:00:30Z
Bundle path: /home/synthestat/output/runs/SE/se_population_review_cycle1_a5ad12d7_seed420987

## Scope
This bundle is the best currently available SE candidate from the existing Synthestat seeded pipeline, not a full national 1:1 Sweden synthesis. It contains 8 synthetic persons in 8 households across 2 seeded DeSO-style zones, with 8 dwellings and 3 seeded building records.

## Measured / constrained / modelled / unavailable
- Measured/constrained: seeded D01-style demographic residuals pass exact HARD checks in the generated validation rows; household/dwelling/building counts are internally consistent for the seeded fixture.
- Modelled: occupation, industry, income, origin, correlation structures, and fine-geography behavioural relationships are model/prior-driven where registry entries mark them modelled or GUIDE.
- Dwelling/building realism: available only as a seeded Lantmäteriet-style fixture with heuristic dwelling inference and B2 building quality; not full live Lantmäteriet/SCB production integration.
- Hidden-population overlays: explicitly unavailable. No homelessness/refugee/asylum/Ukrainian/Syrian/undocumented/seasonal/student/institutional overlay was generated without uncertainty-bounded evidence.
- Work/school/facility assignment: explicitly unavailable because the SE anchor/assignment path is not production-ready.
- Family composition / parent-child age gaps: not materially validated in this seeded output.

## Constraint and uncertainty posture
HARD validation rows in output/SE/validation_report.parquet have exact residuals in this run. FIRM/SOFT/GUIDE precedence is documented in constraint_residuals.json. Modelled components are listed in uncertainty_summary.json with registry uncertainty metadata when available; unavailable components are not silently imputed.

## Candidate modeller self-assessment
Suggested reviewer stance from the modeller: EVIDENCE_EXHAUSTED_HUMAN_REVIEW for this cycle as a seeded/internal bundle, not PASS for production/full-country release. The bundle is contract-complete and honest about degradation, but the current SE artefacts are too small and seeded to satisfy a real national 1:1 Sweden population review without upstream production evidence and anchor/building integration.

build_manifest.json

{
  "assignment_scope": {
    "dwelling_building": "available_seeded",
    "facility": "unavailable",
    "school": "unavailable",
    "work": "unavailable"
  },
  "classification_crosswalk_versions": {
    "education": "ISCED-2011 seeded mapping",
    "industry": "NACE Rev.2/SNI-derived seeded prior",
    "occupation": "ISCO-08/SSYK-derived seeded prior"
  },
  "constraints_relaxed": [],
  "constraints_used": [
    "CORR_OCC_EMPLOYMENT",
    "D01",
    "D12",
    "EMPLOYMENT_CODE_LINK",
    "HH_CHILD_ADULT",
    "HH_COUPLE_TWO_ADULTS",
    "HH_SINGLE_SIZE_ONE",
    "HH_SIZE_PLAUSIBLE",
    "HMN_AGE_RANGE",
    "HMN_BIRTH_DATE",
    "HMN_BUILDING_SCHEMA",
    "HMN_DWELLING_BUILDING_REF",
    "HMN_DWELLING_SCHEMA",
    "HMN_EDUCATION",
    "HMN_EDUCATION_AGE",
    "HMN_EDUCATION_GROUP",
    "HMN_EMPLOYMENT",
    "HMN_HOUSEHOLD_DWELLING_REF",
    "HMN_HOUSEHOLD_SCHEMA",
    "HMN_HOUSEHOLD_TYPE",
    "HMN_INDUSTRY",
    "HMN_MARITAL",
    "HMN_OCCUPATION",
    "HMN_ORIGIN",
    "HMN_PERSON_HOUSEHOLD_REF",
    "HMN_PERSON_SCHEMA",
    "HMN_RETIRED_AGE",
    "HMN_SEX",
    "MODEL_FALLBACK_RATE",
    "SPT_BUILDING_COORDS",
    "SPT_DWELLING_BUILDING_REF",
    "SPT_DWELLING_HOUSEHOLD_REF",
    "SPT_HH_DWELLING_REF",
    "SPT_PERSON_HOUSEHOLD_REF",
    "XCN_COMPARABILITY"
  ],
  "contract_files": [
    "assignment_diagnostics.json",
    "build_manifest.json",
    "constraint_residuals.json",
    "distribution_diagnostics.json",
    "dwelling_building_diagnostics.json",
    "geography_quality_tiers.json",
    "hidden_population_overlays.unavailable.json",
    "household_diagnostics.json",
    "model_notes.md",
    "source_provenance.json",
    "synthetic_building_assignments.parquet",
    "synthetic_dwellings.parquet",
    "synthetic_households.parquet",
    "synthetic_persons.parquet",
    "unavailable.json",
    "uncertainty_summary.json",
    "work_school_assignments.unavailable.json"
  ],
  "country": "SE",
  "created_at": "2026-05-19T14:00:30Z",
  "geography_version": {
    "seeded_test_zones": [
      "DESO_SE_TEST_001",
      "DESO_SE_TEST_002"
    ],
    "target": "SE_DESO_CURRENT"
  },
  "git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba-dirty",
  "git_dirty": true,
  "hidden_population_scope": {
    "categories": [
      "homelessness",
      "refugees/asylum seekers",
      "Ukrainian displaced people",
      "Syrian refugees",
      "undocumented/seasonal populations",
      "students",
      "institutional populations"
    ],
    "evidence_status": "not integrated at uncertainty-bounded review standard",
    "status": "unavailable"
  },
  "known_limitations": [
    "This is a small seeded Sweden review bundle (8 persons, 8 households, 2 DeSO-style test zones), not broad 1:1 national Sweden synthesis.",
    "Building/dwelling layer uses seeded Lantmäteriet-style fixtures and heuristic dwelling inference, not full live Lantmäteriet/SCB integration.",
    "Hidden-population overlays are unavailable; no unsupported point estimates were created.",
    "Work/school/facility assignments are unavailable; anchor engine/source integration is not production-ready for SE.",
    "Family composition and parent-child age gaps are not materially validated in this seeded output.",
    "Fine-geography occupation/industry/income/origin/correlation outputs are model-driven/prior-dominated unless explicitly measured in provenance."
  ],
  "project_root": "/home/synthestat",
  "random_seed": 420987,
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987",
  "source_catalogue_version": {
    "distribution_registry": "output/catalogue/distribution_registry_SE.json",
    "live_registry_ingest": "output/SE/live_registry_ingest_report.json",
    "source_inventory": "output/SE/sources.yaml"
  },
  "zones_degraded": []
}

constraint_residuals.json

{
  "constraint_precedence": [
    "HARD",
    "FIRM",
    "SOFT",
    "GUIDE",
    "INFORMATIONAL"
  ],
  "constraint_type_counts": {
    "FIRM": 2,
    "GUIDE": 2,
    "HARD": 4,
    "HARMONIZATION": 40,
    "INFORMATIONAL": 4,
    "SPATIAL": 10,
    "STRUCTURAL": 10
  },
  "country": "SE",
  "hard_constraint_broken_rows": [],
  "hard_constraint_status": "pass_exact",
  "residual_rows_source": "output/SE/validation_report.parquet",
  "residuals_by_constraint_type": {
    "FIRM": {
      "max_abs_relative_error": 0,
      "row_count": 2,
      "status_counts": {
        "pass": 2
      },
      "tolerance_policy": "normally <=2%"
    },
    "GUIDE": {
      "max_abs_relative_error": 0,
      "row_count": 2,
      "status_counts": {
        "pass": 2
      },
      "tolerance_policy": "prior only"
    },
    "HARD": {
      "max_abs_relative_error": 0,
      "row_count": 4,
      "status_counts": {
        "pass": 4
      },
      "tolerance_policy": "exact"
    },
    "INFORMATIONAL": {
      "max_abs_relative_error": 0,
      "row_count": 4,
      "status_counts": {
        "pass": 2,
        "skip": 2
      },
      "tolerance_policy": "not constraining"
    }
  },
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987",
  "status_counts": {
    "pass": 70,
    "skip": 2
  },
  "validation_row_count": 72
}

household_diagnostics.json

{
  "country": "SE",
  "evidence_depth_counts": {
    "well_constrained": 8
  },
  "family_composition_scope": "limited_seeded_household_types_only; no validated parent-child age-gap model active in this slice",
  "household_count": 8,
  "household_role_counts": {
    "reference": 8
  },
  "household_size_counts": {
    "1": 8
  },
  "household_type_counts": {
    "HH_SINGLE_E": 2,
    "HH_SINGLE_M": 3,
    "HH_SINGLE_Y": 3
  },
  "parent_child_age_gap_status": "unavailable_no_multi_person_family_evidence_in_current_seeded_outputs",
  "person_count": 8,
  "persons_without_household": [],
  "quality_tier_counts": {
    "A": 8
  },
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987"
}

dwelling_building_diagnostics.json

{
  "assignment_count": 8,
  "building_count": 3,
  "building_data_quality_tier_counts": {
    "B2": 3
  },
  "building_quality_tier": "B2",
  "building_source_status": "seeded Lantmäteriet-style fixture, not full live Lantmäteriet/SCB building integration",
  "capacity_check": {
    "dwelling_count": 8,
    "household_count": 8,
    "ok": true,
    "shortfall": 0
  },
  "country": "SE",
  "dwelling_count": 8,
  "dwelling_status_counts": {
    "inferred": 7,
    "observed": 1
  },
  "households_with_building_assignment": 8,
  "households_with_dwelling_assignment": 8,
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987",
  "zone_counts": {
    "DESO_SE_TEST_001": 2,
    "DESO_SE_TEST_002": 1
  }
}

distribution_diagnostics.json

{
  "confidence_below_0_7": [
    {
      "catalogue_id": "literature:se-c01_education_occupation_coupling",
      "confidence": 0.635,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "SE_KOM_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.172,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:se-c02_assortative_mating_education",
      "confidence": 0.645,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "SE_KOM_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.163,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:se-c04_assortative_mating_origin",
      "confidence": 0.655,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "SE_KOM_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.163,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:se-c08_intergenerational_income_elasticity",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "SE_KOM_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.193,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:se-c09_intergenerational_occupation_transmission",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "SE_KOM_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.193,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:se-c10_commuting_mode_distance",
      "confidence": 0.675,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "geo_version": "SE_KOM_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.152,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:se-c11_health_age_sex_education",
      "confidence": 0.655,
      "constraint_type": "GUIDE",
      "country": "SE",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "SE_KOM_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.163,
        "method": "literature_regression"
      }
    }
  ],
  "constraint_type_counts": {
    "FIRM": 7,
    "GUIDE": 18,
    "HARD": 2,
    "SOFT": 11
  },
  "country": "SE",
  "coverage": {
    "by_attribute_family": {
      "correlational": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "C01_education_occupation_coupling",
          "C02_assortative_mating_education",
          "C03_assortative_mating_age",
          "C04_assortative_mating_origin",
          "C05_spatial_sorting_education",
          "C06_spatial_sorting_income",
          "C07_spatial_sorting_origin",
          "C08_intergenerational_income_elasticity",
          "C09_intergenerational_occupation_transmission",
          "C10_commuting_mode_distance"
        ],
        "covered_count": 10,
        "missing": [],
        "missing_count": 0,
        "required_count": 10,
        "usable_count": 10,
        "usable_ratio": 1.0
      },
      "culture": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D04_religion_age_sex_region"
        ],
        "covered_count": 1,
        "missing": [],
        "missing_count": 0,
        "required_count": 1,
        "usable_count": 1,
        "usable_ratio": 1.0
      },
      "demographics": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D01_age_sex_nuts3",
          "D01_census_age_sex_nuts3"
        ],
        "covered_count": 2,
        "missing": [],
        "missing_count": 0,
        "required_count": 2,
        "usable_count": 2,
        "usable_ratio": 1.0
      },
      "education": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D05_census_education_nuts3",
          "D05_education_nuts2"
        ],
        "covered_count": 2,
        "missing": [],
        "missing_count": 0,
        "required_count": 2,
        "usable_count": 2,
        "usable_ratio": 1.0
      },
      "employment": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D06_employment_age_sex_education",
          "D19_employment_given_demographics"
        ],
        "covered_count": 2,
        "missing": [],
        "missing_count": 0,
        "required_count": 2,
        "usable_count": 2,
        "usable_ratio": 1.0
      },
      "fertility": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D13_children_mother_age_education",
          "D20_birth_intervals",
          "D21_age_first_birth"
        ],
        "covered_count": 3,
        "missing": [],
        "missing_count": 0,
        "required_count": 3,
        "usable_count": 3,
        "usable_ratio": 1.0
      },
      "health": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "C11_health_age_sex_education"
        ],
        "covered_count": 1,
        "missing": [],
        "missing_count": 0,
        "required_count": 1,
        "usable_count": 1,
        "usable_ratio": 1.0
      },
      "households": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D02_marital_nuts3",
          "D12_household_type_size_region",
          "D14_partner_age_gap_homogamy",
          "D15_coresidence_structure",
          "D22_age_leaving_home",
          "D23_divorce_duration_children_education",
          "D24_age_marriage_sex_education"
        ],
        "covered_count": 7,
        "missing": [],
        "missing_count": 0,
        "required_count": 7,
        "usable_count": 7,
        "usable_ratio": 1.0
      },
      "income": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D10_income_education_occupation",
          "D11_income_household_type_region",
          "D16_household_income_type_region"
        ],
        "covered_count": 3,
        "missing": [],
        "missing_count": 0,
        "required_count": 3,
        "usable_count": 3,
        "usable_ratio": 1.0
      },
      "industry": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D09_industry_nace2"
        ],
        "covered_count": 1,
        "missing": [],
        "missing_count": 0,
        "required_count": 1,
        "usable_count": 1,
        "usable_ratio": 1.0
      },
      "migration": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D03_origin_age_sex",
          "D25_internal_migration"
        ],
        "covered_count": 2,
        "missing": [],
        "missing_count": 0,
        "required_count": 2,
        "usable_count": 2,
        "usable_ratio": 1.0
      },
      "mobility": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D17_education_mobility"
        ],
        "covered_count": 1,
        "missing": [],
        "missing_count": 0,
        "required_count": 1,
        "usable_count": 1,
        "usable_ratio": 1.0
      },
      "occupation": {
        "below_quality": [],
        "below_quality_count": 0,
        "coverage_ratio": 1.0,
        "covered": [
          "D07_occupation_isco3",
          "D08_occupation_education",
          "D18_occupation_gi

… truncated after 12,000 characters …

uncertainty_summary.json

{
  "component_uncertainty_notes": {
    "dwellings_buildings": "Lantmäteriet-style fixture with heuristic dwelling inference; B2 quality tier.",
    "hidden_populations": "Unavailable rather than point-estimated without bounds.",
    "persons_households": "Seeded synthesis constrained by validation rows; occupation/industry/income/origin and correlations remain modelled/prior-dominated where not directly measured.",
    "work_school_assignments": "Unavailable rather than generated without anchor/facility evidence."
  },
  "country": "SE",
  "modelled_or_weakly_measured_components": [
    {
      "confidence": 0.635,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "spec_id": "C01_education_occupation_coupling",
      "spec_label": "Education-occupation coupling strength",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.172,
        "method": "literature_regression"
      }
    },
    {
      "confidence": 0.645,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "pooling_level": "municipality",
      "spec_id": "C02_assortative_mating_education",
      "spec_label": "Assortative mating by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.163,
        "method": "literature_transition"
      }
    },
    {
      "confidence": 0.715,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "pooling_level": "municipality",
      "spec_id": "C03_assortative_mating_age",
      "spec_label": "Assortative mating by age",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.112,
        "method": "literature_transition"
      }
    },
    {
      "confidence": 0.655,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "pooling_level": "municipality",
      "spec_id": "C04_assortative_mating_origin",
      "spec_label": "Assortative mating by origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.163,
        "method": "literature_transition"
      }
    },
    {
      "confidence": 0.735,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "spec_id": "C05_spatial_sorting_education",
      "spec_label": "Spatial sorting by education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.103,
        "method": "literature_prior"
      }
    },
    {
      "confidence": 0.735,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "spec_id": "C06_spatial_sorting_income",
      "spec_label": "Spatial sorting by income",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.103,
        "method": "literature_prior"
      }
    },
    {
      "confidence": 0.755,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "spec_id": "C07_spatial_sorting_origin",
      "spec_label": "Spatial sorting by origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.092,
        "method": "literature_prior"
      }
    },
    {
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "spec_id": "C08_intergenerational_income_elasticity",
      "spec_label": "Intergenerational income elasticity",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.193,
        "method": "literature_prior"
      }
    },
    {
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "spec_id": "C09_intergenerational_occupation_transmission",
      "spec_label": "Intergenerational occupation transmission",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.193,
        "method": "literature_regression"
      }
    },
    {
      "confidence": 0.675,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "municipality",
      "pooling_level": "municipality",
      "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.152,
        "method": "literature_transition"
      }
    },
    {
      "confidence": 0.655,
      "constraint_type": "GUIDE",
      "dataset_variant": "literature",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "pooling_level": "national",
      "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.163,
        "method": "literature_regression"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "NUTS-3",
      "pooling_level": "nuts-3",
      "spec_id": "D04_religion_age_sex_region",
      "spec_label": "Religion × age × sex × region",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "unknown",
      "pooling_level": "unknown",
      "spec_id": "D17_education_mobility",
      "spec_label": "Education mobility",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "unknown",
      "pooling_level": "unknown",
      "spec_id": "D20_birth_intervals",
      "spec_label": "Birth intervals",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "unknown",
      "pooling_level": "unknown",
      "spec_id": "D21_age_first_birth",
      "spec_label": "Age at first birth × education × cohort",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "unknown",
      "pooling_level": "unknown",
      "spec_id": "D22_age_leaving_home",
      "spec_label": "Age leaving home",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "NUTS-3",
      "pooling_level": "nuts-3",
      "spec_id": "D23_divorce_duration_children_education",
      "spec_label": "Divorce × duration × children × education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    },
    {
      "confidence": 0.71,
      "constraint_type": "GUIDE",
      "dataset_variant": "robust",
      "evidence_quality": "official_supranational_census_or_admin",
      "finest_geography_status": "constrained",
      "geo_level": "NUTS-3",
      "pooling_level": "nuts-3",
      "spec_id": "D24_age_marriage_sex_education",
      "spec_label": "Age at marriage × sex × education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.29,
        "method": "heuristic_range"
      }
    }
  ],
  "principle": "model-based estimates without uncertainty bounds are invalid; modelled components are flagged and include registry uncertainty metadata when available",
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987",
  "seeded_population_scope": {
    "households": 8,
    "not_full_country": true,
    "persons": 8,
    "zones": [
      "DESO_SE_TEST_001",
      "DESO_SE_TEST_002"
    ]
  },
  "validation_status_counts": {
    "pass": 70,
    "skip": 2
  }
}

source_provenance.json

{
  "country": "SE",
  "distribution_registry_path": "output/catalogue/distribution_registry_SE.json",
  "live_registry_entry_count": 5,
  "live_registry_paths": {
    "probe": "output/SE/scb_live_probe.json",
    "registry": "output/SE/live_distribution_registry.json",
    "samples": "output/SE/scb_live_samples.json"
  },
  "registry_entry_count": 38,
  "retrieval_timestamp_policy": "Preserve when known; seeded source inventory lacks exact retrieval timestamps for most sources, so null is explicit rather than inferred.",
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987",
  "source_inventory_path": "output/SE/sources.yaml",
  "sources": [
    {
      "confidence": 0.98,
      "constraint_type": "HARD",
      "dataset_code": "BE0101_deso",
      "dataset_name": "SCB population statistics by DeSO/municipality/county",
      "finest_geography_status": "measured",
      "geography_level": "deso",
      "geography_version": "SE_DESO_CURRENT",
      "known_issues": [
        "PX-Web table discovery is often easier in Swedish than English."
      ],
      "provider": "scb",
      "quality_status": "official_register_statistics",
      "reference_period": "annual",
      "retrieval_method": "pxweb_api_or_table_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.scb.se/en/finding-statistics/",
      "source_id": "SE_SCB_population_deso",
      "variables": [
        "age",
        "sex",
        "geo"
      ]
    },
    {
      "confidence": 0.96,
      "constraint_type": "FIRM",
      "dataset_code": "household_dwelling_statistics",
      "dataset_name": "SCB household-dwelling register statistics",
      "finest_geography_status": "constrained",
      "geography_level": "municipality_or_above",
      "geography_version": "SE_MUNICIPALITY_CURRENT",
      "known_issues": [
        "Some household outputs are stronger at municipality level than at the finest DeSO geography."
      ],
      "provider": "scb",
      "quality_status": "official_register_statistics",
      "reference_period": "annual",
      "retrieval_method": "pxweb_table_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.scb.se/en/finding-statistics/",
      "source_id": "SE_SCB_household_dwelling",
      "variables": [
        "household_type",
        "household_size",
        "geo"
      ]
    },
    {
      "confidence": 0.95,
      "constraint_type": "FIRM",
      "dataset_code": "UF0506",
      "dataset_name": "SCB educational attainment of the population",
      "finest_geography_status": "constrained",
      "geography_level": "municipality_or_above",
      "geography_version": "SE_MUNICIPALITY_CURRENT",
      "known_issues": [
        "Needs harmonization from Swedish education categories to ISCED."
      ],
      "provider": "scb",
      "quality_status": "official_register_statistics",
      "reference_period": "annual",
      "retrieval_method": "pxweb_api_or_table_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.scb.se/en/finding-statistics/",
      "source_id": "SE_SCB_education_attainment",
      "variables": [
        "education_level",
        "age",
        "sex",
        "geo"
      ]
    },
    {
      "confidence": 0.94,
      "constraint_type": "SOFT",
      "dataset_code": "RAMS_LISA",
      "dataset_name": "SCB register-based labour market statistics and LISA-linked outputs",
      "finest_geography_status": "constrained",
      "geography_level": "municipality_or_above",
      "geography_version": "SE_MUNICIPALITY_CURRENT",
      "known_issues": [
        "Not every RAMS/LISA table is equally available at DeSO; some outputs require coarser geography or research access."
      ],
      "provider": "scb",
      "quality_status": "official_register_statistics",
      "reference_period": "annual",
      "retrieval_method": "pxweb_table_download_or_research_extract",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.scb.se/en/finding-statistics/",
      "source_id": "SE_SCB_RAMS_LISA",
      "variables": [
        "employment_status",
        "occupation_ssyk",
        "industry_sni",
        "income",
        "geo"
      ]
    },
    {
      "confidence": 0.92,
      "constraint_type": "SOFT",
      "dataset_code": "income_tax_statistics",
      "dataset_name": "SCB income and tax statistics",
      "finest_geography_status": "constrained",
      "geography_level": "municipality_or_above",
      "geography_version": "SE_MUNICIPALITY_CURRENT",
      "known_issues": [
        "Individual income and household disposable income concepts differ and need explicit handling."
      ],
      "provider": "scb",
      "quality_status": "official_admin",
      "reference_period": "annual",
      "retrieval_method": "pxweb_table_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.scb.se/en/finding-statistics/",
      "source_id": "SE_SCB_income_tax",
      "variables": [
        "income",
        "tax",
        "household_type",
        "geo"
      ]
    },
    {
      "confidence": 0.97,
      "constraint_type": "HARD",
      "dataset_code": "deso_regso_geographies",
      "dataset_name": "SCB DeSO and related statistical geographies",
      "finest_geography_status": "measured",
      "geography_level": "deso_and_above",
      "geography_version": "SE_DESO_CURRENT",
      "known_issues": [
        "Statistical geographies and administrative boundaries are not interchangeable."
      ],
      "provider": "scb",
      "quality_status": "official_geographic_reference",
      "reference_period": "annual",
      "retrieval_method": "official_reference_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.scb.se/en/finding-statistics/",
      "source_id": "SE_SCB_geographies",
      "variables": [
        "zone_code",
        "parent_municipality",
        "labels"
      ]
    },
    {
      "confidence": 0.95,
      "constraint_type": "HARD",
      "dataset_code": "administrative_boundaries",
      "dataset_name": "Lantmäteriet administrative boundary geodata",
      "finest_geography_status": "measured",
      "geography_level": "municipality_and_county",
      "geography_version": "SE_BOUNDARIES_CURRENT",
      "known_issues": [
        "Administrative boundaries and SCB statistical geographies require explicit concordances."
      ],
      "provider": "lantmateriet",
      "quality_status": "official_geospatial",
      "reference_period": "current",
      "retrieval_method": "official_geodata_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.lantmateriet.se/en/",
      "source_id": "SE_LANTMATERIET_boundaries",
      "variables": [
        "geometry",
        "codes",
        "labels"
      ]
    },
    {
      "confidence": 0.88,
      "constraint_type": "FIRM",
      "dataset_code": "building_footprints",
      "dataset_name": "Lantmäteriet building footprints and open geodata",
      "finest_geography_status": "measured",
      "geography_level": "individual_building",
      "geography_version": "SE_BUILDINGS_CURRENT",
      "known_issues": [
        "Open building geometry is not equivalent to the restricted dwelling register and still needs dwelling inference."
      ],
      "provider": "lantmateriet",
      "quality_status": "official_geospatial",
      "reference_period": "current",
      "retrieval_method": "official_geodata_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.lantmateriet.se/en/",
      "source_id": "SE_LANTMATERIET_buildings",
      "variables": [
        "building_geometry",
        "building_type",
        "coordinates"
      ]
    },
    {
      "confidence": 0.84,
      "constraint_type": "GUIDE",
      "dataset_code": "school_statistics",
      "dataset_name": "Skolverket school statistics portal",
      "finest_geography_status": "informational",
      "geography_level": "school_or_municipality",
      "geography_version": "SE_SCHOOL_CURRENT",
      "known_issues": [
        "Useful as education-system context, but not the primary resident-population attainment source."
      ],
      "provider": "skolverket",
      "quality_status": "official_admin",
      "reference_period": "annual",
      "retrieval_method": "official_table_download",
      "retrieval_timestamp": null,
      "retrieval_url": "https://www.skolverket.se/",
      "source_id": "SE_SKOLVERKET_school_stats",
      "variables": [
        "enrolment",
        "school_type",
        "municipality"
      ]
    }
  ]
}

unavailable.json

{
  "country": "SE",
  "note": "Artifact-specific *.unavailable.json files are also present for explicit contract handling.",
  "run_id": "se_population_review_cycle1_a5ad12d7_seed420987",
  "status": "partial_unavailability_manifest",
  "unavailable_artifacts": {
    "hidden_population_overlays": {
      "artifact": "hidden_population_overlays",
      "categories_requested": [
        "homelessness",
        "refugees_asylum_seekers",
        "ukrainian_displaced_people",
        "syrian_refugees",
        "undocumented_or_seasonal_populations",
        "students",
        "institutional_populations"
      ],
      "contract_handling": "explicit_unavailable_artifact",
      "country": "SE",
      "created_at": "2026-05-19T14:00:30Z",
      "effect_on_de_jure_population": "none; overlay omitted rather than rewriting resident constraints",
      "quality_flag": "missing_evidence_not_silently_modelled",
      "reason": "No currently integrated Sweden hidden-population distribution source supports responsible uncertainty-bounded overlays in this seeded review slice.",
      "required_evidence": [
        "category-specific counts by municipality/DeSO or defensible allocation geography",
        "reference period and population definition for each category",
        "uncertainty bounds or enough metadata to construct bounds"
      ],
      "status": "unavailable"
    },
    "work_school_assignments": {
      "artifact": "work_school_assignments",
      "contract_handling": "explicit_unavailable_artifact",
      "country": "SE",
      "created_at": "2026-05-19T14:00:30Z",
      "quality_flag": "missing_evidence_not_silently_modelled",
      "reason": "Anchor/assignment engine is not production-ready for Sweden in current seeded slice; no work/school facility assignment source has been integrated at review-bundle standard.",
      "required_evidence": [
        "workplace/school destination marginals or origin-destination flows by geography",
        "school/facility register with capacity and geocodes",
        "commuting mode/distance calibration with uncertainty"
      ],
      "scope": {
        "facilities": "unavailable",
        "school": "unavailable",
        "work": "unavailable"
      },
      "status": "unavailable"
    }
  }
}