pt_population_review_cycle1_d828fc79_seed420987

Local run directory: /home/synthestat/output/runs/PT/pt_population_review_cycle1_d828fc79_seed420987

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

Output status

People	Households	Dwellings	Houses/buildings	Max marginal deviation	HARD status	Validation rows
8	8	8	3	0.00%	pass_exact	74

Run files

File	Bytes	Kind
`assignment_diagnostics.json`	804	file
`build_manifest.json`	6,709	file
`constraint_residuals.json`	5,016	file
`distribution_diagnostics.json`	21,391	file
`dwelling_building_diagnostics.json`	2,804	file
`geography_quality_tiers.json`	14,761	file
`hidden_population_overlays.unavailable.json`	1,855	file
`household_diagnostics.json`	3,287	file
`model_notes.md`	2,912	file
`source_provenance.json`	41,831	file
`synthetic_building_assignments.parquet`	3,582	file
`synthetic_dwellings.parquet`	2,622	file
`synthetic_households.parquet`	2,950	file
`synthetic_persons.parquet`	5,600	file
`unavailable.json`	1,914	file
`uncertainty_summary.json`	17,239	file
`work_school_assignments.unavailable.json`	849	file

Datasets and distributions

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

Summary

Datasets used	7
Distributions available	38
Constraints/distributions used in synthesis	43
Constraint types	FIRM: 7, GUIDE: 18, HARD: 2, SOFT: 11
Dataset variants	comparable_country: 11, current: 1, robust: 26
Finest-geography status	constrained: 27, modelled: 11

Source gaps

Live PT INE probe/download is disabled for this run; no endpoint reachability claims are made.
Building/context fixtures still require dwelling inference; no live Cadastro dwelling integration exists in this repo.
Current Portugal implementation is still a seeded source-inventory slice and not yet a production nationwide extraction pipeline.

Datasets used

Dataset/source ID
`PT_CADASTRO_seeded_buildings`
`PT_INE_education`
`PT_INE_employment`
`PT_INE_households`
`PT_INE_income`
`PT_INE_population`
`PT_INE_section_reference`

Best source by distribution family

Distribution family	Dataset/source ID
`D01_demographics_finest`	`PT_INE_population`
`D05_education`	`PT_INE_education`
`D12_household_type`	`PT_INE_households`
`building_stock`	`PT_CADASTRO_seeded_buildings`
`employment_occupation_industry`	`PT_INE_employment`
`geography_boundaries`	`PT_INE_section_reference`
`income`	`PT_INE_income`

Available distributions / priors in registry

Spec	Label	Type	Geo	Status	Variant	Confidence	Data URI
`C01_education_occupation_coupling`	Education-occupation coupling strength	GUIDE	national	modelled	comparable_country	0.595	`data/literature/seeded_occupation_priors.yaml`
`C02_assortative_mating_education`	Assortative mating by education	GUIDE	commune	modelled	comparable_country	0.605	`data/literature/seeded_occupation_priors.yaml`
`C03_assortative_mating_age`	Assortative mating by age	GUIDE	commune	modelled	comparable_country	0.675	`data/literature/seeded_occupation_priors.yaml`
`C04_assortative_mating_origin`	Assortative mating by origin	GUIDE	commune	modelled	comparable_country	0.615	`data/literature/seeded_occupation_priors.yaml`
`C05_spatial_sorting_education`	Spatial sorting by education	GUIDE	national	modelled	comparable_country	0.695	`data/literature/seeded_occupation_priors.yaml`
`C06_spatial_sorting_income`	Spatial sorting by income	GUIDE	national	modelled	comparable_country	0.695	`data/literature/seeded_occupation_priors.yaml`
`C07_spatial_sorting_origin`	Spatial sorting by origin	GUIDE	national	modelled	comparable_country	0.715	`data/literature/seeded_occupation_priors.yaml`
`C08_intergenerational_income_elasticity`	Intergenerational income elasticity	GUIDE	national	modelled	comparable_country	0.575	`data/literature/seeded_occupation_priors.yaml`
`C09_intergenerational_occupation_transmission`	Intergenerational occupation transmission	GUIDE	national	modelled	comparable_country	0.575	`data/literature/seeded_occupation_priors.yaml`
`C10_commuting_mode_distance`	Commuting mode × distance × occupation × region	GUIDE	commune	modelled	comparable_country	0.635	`data/literature/seeded_occupation_priors.yaml`
`C11_health_age_sex_education`	Health × age × sex × education	GUIDE	national	modelled	comparable_country	0.615	`data/literature/seeded_occupation_priors.yaml`
`D01_age_sex_nuts3`	Age × sex at NUTS-3	HARD	NUTS-3	constrained	robust	0.74	`docs/wiki/compiled/D01_age_sex_nuts3.md`
`D01_census_age_sex_nuts3`	Census age × sex at NUTS-3	HARD	NUTS-3	constrained	robust	0.74	`docs/wiki/compiled/D01_census_age_sex_nuts3.md`
`D02_marital_nuts3`	Marital status × age × sex at NUTS-3	FIRM	NUTS-3	constrained	robust	0.73	`docs/wiki/compiled/D02_marital_nuts3.md`
`D03_origin_age_sex`	Origin group × age × sex	FIRM	NUTS-3	constrained	robust	0.73	`docs/wiki/compiled/D03_origin_age_sex.md`
`D04_religion_age_sex_region`	Religion × age × sex × region	GUIDE	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D04_religion_age_sex_region.md`
`D05_census_education_nuts3`	Census education at NUTS-3	FIRM	NUTS-3	constrained	robust	0.73	`docs/wiki/compiled/D05_census_education_nuts3.md`
`D05_education_nuts2`	Education at NUTS-2	FIRM	NUTS-2	constrained	current	0.7	`docs/wiki/compiled/D05_education_nuts2.md`
`D06_employment_age_sex_education`	Employment status × age × sex × education	FIRM	unknown	constrained	robust	0.73	`docs/wiki/compiled/D06_employment_age_sex_education.md`
`D07_occupation_isco3`	Occupation ISCO-3 distribution	SOFT	unknown	constrained	robust	0.71	`docs/wiki/compiled/D07_occupation_isco3.md`
`D08_occupation_education`	Occupation × education	SOFT	unknown	constrained	robust	0.71	`docs/wiki/compiled/D08_occupation_education.md`
`D09_industry_nace2`	Industry NACE-2 distribution	SOFT	unknown	constrained	robust	0.71	`docs/wiki/compiled/D09_industry_nace2.md`
`D10_income_education_occupation`	Income × education × occupation	SOFT	unknown	constrained	robust	0.71	`docs/wiki/compiled/D10_income_education_occupation.md`
`D11_income_household_type_region`	Income × household type × region	SOFT	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D11_income_household_type_region.md`
`D12_household_type_size_region`	Household type × size × region	FIRM	NUTS-3	constrained	robust	0.73	`docs/wiki/compiled/D12_household_type_size_region.md`
`D13_children_mother_age_education`	Children × mother age × education	SOFT	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D13_children_mother_age_education.md`
`D14_partner_age_gap_homogamy`	Partner age gap × homogamy	SOFT	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D14_partner_age_gap_homogamy.md`
`D15_coresidence_structure`	Co-residence structure	SOFT	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D15_coresidence_structure.md`
`D16_household_income_type_region`	Household income × type × region	SOFT	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D16_household_income_type_region.md`
`D17_education_mobility`	Education mobility	GUIDE	unknown	constrained	robust	0.71	`docs/wiki/compiled/D17_education_mobility.md`
`D18_occupation_given_education`	Occupation \| education	SOFT	unknown	constrained	robust	0.71	`docs/wiki/compiled/D18_occupation_given_education.md`
`D19_employment_given_demographics`	Employment \| demographics	SOFT	unknown	constrained	robust	0.71	`docs/wiki/compiled/D19_employment_given_demographics.md`
`D20_birth_intervals`	Birth intervals	GUIDE	unknown	constrained	robust	0.71	`docs/wiki/compiled/D20_birth_intervals.md`
`D21_age_first_birth`	Age at first birth × education × cohort	GUIDE	unknown	constrained	robust	0.71	`docs/wiki/compiled/D21_age_first_birth.md`
`D22_age_leaving_home`	Age leaving home	GUIDE	unknown	constrained	robust	0.71	`docs/wiki/compiled/D22_age_leaving_home.md`
`D23_divorce_duration_children_education`	Divorce × duration × children × education	GUIDE	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D23_divorce_duration_children_education.md`
`D24_age_marriage_sex_education`	Age at marriage × sex × education	GUIDE	NUTS-3	constrained	robust	0.71	`docs/wiki/compiled/D24_age_marriage_sex_education.md`
`D25_internal_migration`	Internal migration	FIRM	unknown	constrained	robust	0.73	`docs/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_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`
`INFORMATIONAL`
`MODEL_FALLBACK_RATE`
`MODEL_REGISTRY_PROFILE`
`SPATIAL`
`SPT_BUILDING_COORDS`
`SPT_DWELLING_BUILDING_REF`
`SPT_DWELLING_HOUSEHOLD_REF`
`SPT_HH_DWELLING_REF`
`SPT_PERSON_HOUSEHOLD_REF`
`STRUCTURAL`
`XCN_COMPARABILITY`

model_notes.md

# PT population review bundle — cycle 1

Run ID: `pt_population_review_cycle1_d828fc79_seed420987`
Bundle path: `/home/synthestat/output/runs/PT/pt_population_review_cycle1_d828fc79_seed420987`
Created at: 2026-05-19T16:52:41Z
Release mode: internal research review.

## What this bundle is

This is the best current Portugal review bundle that can be produced from the existing Synthestat source/code layer without fabricating precision. It packages the seeded Portugal population slice: 8 synthetic persons in 8 households, linked to 8 inferred/seeded dwellings and 3 Cadastro-style seeded buildings across 2 secao-estatistica-style test zones (`SEC_PT_TEST_001`, `SEC_PT_TEST_002`).

## HARD residual status

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

Validation summary: {'pass': 68, 'warn': 4, 'skip': 2} across 74 rows. Warning 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/transfer inputs are listed in `distribution_diagnostics.json`, `uncertainty_summary.json`, and `source_provenance.json`. Hidden populations are explicitly unavailable because the current PT 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 Portugal 1:1 synthesis.
- Current finest supported geography is seeded secao-estatistica-style test zones, not all Portuguese small areas.
- Building/dwelling realism is seeded Cadastro-style fixture plus dwelling inference, not live national building-register assignment; occupied synthetic dwellings now carry the household_id linked from synthetic households.
- HH_SINGLE_Y/M/E are explicit seeded single-person age-band labels: Y=18-34, M=35-64, E=65+. Person birth dates are remediated to sit inside those bands for this review bundle.
- Occupation/industry at fine geography are modelled; ISCO-3 is unavailable and flagged as `fallback_1digit`.
- Distribution diagnostics explicitly warn on remaining degenerate seeded person attributes so repeated values are not overread as measured distribution realism.
- Source inventory for this run did not enable live PT INE probe/download; current bundle relies on existing seeded/manual catalogue artifacts, and source provenance marks missing retrieval timestamp/licence/source-universe fields per source.

## Expected routing

The bundle is contract-complete for synth-reviewer inspection after cycle-1 remediation of the dwelling-household reference overclaim, HH_SINGLE_Y/M/E age semantics, provenance metadata explicitness, and seeded attribute-degeneracy diagnostics. Remaining unavailable layers should be reviewed as evidence gaps, not silent failures.

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 seeded/modelled mapping",
    "occupation": "ISCO-08 seeded/modelled fallback to 1 digit"
  },
  "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_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",
    "INFORMATIONAL",
    "MODEL_FALLBACK_RATE",
    "MODEL_REGISTRY_PROFILE",
    "SPATIAL",
    "SPT_BUILDING_COORDS",
    "SPT_DWELLING_BUILDING_REF",
    "SPT_DWELLING_HOUSEHOLD_REF",
    "SPT_HH_DWELLING_REF",
    "SPT_PERSON_HOUSEHOLD_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": "PT",
  "created_at": "2026-05-19T16:52:41Z",
  "firm_soft_status": {
    "residuals_by_constraint_type": {
      "FIRM": {
        "max_abs_relative_error": 0.0,
        "row_count": 2,
        "status_counts": {
          "pass": 2
        },
        "tolerance_policy": "normally <=2%"
      },
      "GUIDE": {
        "max_abs_relative_error": 0.0,
        "row_count": 2,
        "status_counts": {
          "pass": 2
        },
        "tolerance_policy": "prior only"
      },
      "HARD": {
        "max_abs_relative_error": 0.0,
        "row_count": 4,
        "status_counts": {
          "pass": 4
        },
        "tolerance_policy": "exact"
      },
      "HARMONIZATION": {
        "max_abs_relative_error": 0.0,
        "row_count": 40,
        "status_counts": {
          "pass": 40
        },
        "tolerance_policy": "structural/harmonization check; see validation rows"
      },
      "INFORMATIONAL": {
        "max_abs_relative_error": 1.0,
        "row_count": 6,
        "status_counts": {
          "skip": 2,
          "warn": 4
        },
        "tolerance_policy": "not constraining"
      },
      "SPATIAL": {
        "max_abs_relative_error": 0.0,
        "row_count": 10,
        "status_counts": {
          "pass": 10
        },
        "tolerance_policy": "structural/harmonization check; see validation rows"
      },
      "STRUCTURAL": {
        "max_abs_relative_error": 0.0,
        "row_count": 10,
        "status_counts": {
          "pass": 10
        },
        "tolerance_policy": "structural/harmonization check; see validation rows"
      }
    },
    "status_counts": {
      "pass": 68,
      "skip": 2,
      "warn": 4
    }
  },
  "geography_version": {
    "seeded_test_zones": [
      "SEC_PT_TEST_001",
      "SEC_PT_TEST_002"
    ],
    "target": "PT_SECAO_ESTATISTICA_SEEDED_REVIEW"
  },
  "git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba-dirty",
  "git_dirty": true,
  "hard_constraint_status": "pass_exact",
  "hidden_population_scope": {
    "homelessness": {
      "reason": "No Portugal small-area measured homelessness distribution with uncertainty bounds is integrated in the current PT synthesis layer.",
      "status": "unavailable"
    },
    "institutional_populations": {
      "reason": "No institutional/group-quarter person layer is integrated for Portugal in the current seeded path.",
      "status": "unavailable"
    },
    "refugees_asylum_seekers": {
      "reason": "No integrated age/sex/household/secao-estatistica or municipality distribution with bounds exists in current PT bundle inputs.",
      "status": "unavailable"
    },
    "students": {
      "reason": "Education status exists only as a modelled person attribute; no separate student-location, school register/capacity, or assignment overlay is available.",
      "status": "unavailable_overlay"
    },
    "syrian_refugees": {
      "reason": "No Portugal-specific small-area measured Syrian refugee source with bounds is integrated; model-only synthesis would violate uncertainty rules.",
      "status": "unavailable"
    },
    "ukrainian_displaced_people": {
      "reason": "Policy-relevant group, but no separate uncertainty-aware Portugal overlay source is wired into the current seeded path.",
      "status": "unavailable"
    },
    "undocumented_seasonal_populations": {
      "reason": "No measured Portugal distribution with uncertainty bounds exists in current repo inputs.",
      "status": "unavailable"
    }
  },
  "known_limitations": [
    "Small seeded PT review slice only: 2 secao-estatistica-style test zones, 8 persons/households; not nationwide 1:1 Portugal synthesis.",
    "Live PT INE probe/download disabled for this source-inventory run; no endpoint reachability claims are made.",
    "Buildings are Cadastro-style seeded fixtures; dwellings may be inferred and are not full national register integration.",
    "Hidden populations and work/school assignments unavailable rather than modelled without bounds.",
    "Fine occupation detail is model-driven/fallback; ISCO-3 unavailable and flagged as fallback_1digit."
  ],
  "population_counts": {
    "buildings": 3,
    "dwellings": 8,
    "households": 8,
    "persons": 8
  },
  "project_root": "/home/synthestat",
  "random_seed": 420987,
  "release_mode": "internal_research_review",
  "run_id": "pt_population_review_cycle1_d828fc79_seed420987",
  "source_catalogue_version": {
    "readiness_status": "pass",
    "registry": "output/catalogue/distribution_registry_PT.json",
    "source_inventory_report": "output/PT/source_inventory_report.json"
  },
  "zones_degraded": []
}

constraint_residuals.json

{
  "constraint_precedence": [
    "HARD",
    "FIRM",
    "SOFT",
    "GUIDE",
    "INFORMATIONAL"
  ],
  "constraint_type_counts": {
    "FIRM": 2,
    "GUIDE": 2,
    "HARD": 4,
    "HARMONIZATION": 40,
    "INFORMATIONAL": 6,
    "SPATIAL": 10,
    "STRUCTURAL": 10
  },
  "country": "PT",
  "hard_constraint_broken_rows": [],
  "hard_constraint_status": "pass_exact",
  "residual_rows_source": "output/PT/validation_report.parquet",
  "residuals_by_constraint_type": {
    "FIRM": {
      "max_abs_relative_error": 0.0,
      "row_count": 2,
      "status_counts": {
        "pass": 2
      },
      "tolerance_policy": "normally <=2%"
    },
    "GUIDE": {
      "max_abs_relative_error": 0.0,
      "row_count": 2,
      "status_counts": {
        "pass": 2
      },
      "tolerance_policy": "prior only"
    },
    "HARD": {
      "max_abs_relative_error": 0.0,
      "row_count": 4,
      "status_counts": {
        "pass": 4
      },
      "tolerance_policy": "exact"
    },
    "HARMONIZATION": {
      "max_abs_relative_error": 0.0,
      "row_count": 40,
      "status_counts": {
        "pass": 40
      },
      "tolerance_policy": "structural/harmonization check; see validation rows"
    },
    "INFORMATIONAL": {
      "max_abs_relative_error": 1.0,
      "row_count": 6,
      "status_counts": {
        "skip": 2,
        "warn": 4
      },
      "tolerance_policy": "not constraining"
    },
    "SPATIAL": {
      "max_abs_relative_error": 0.0,
      "row_count": 10,
      "status_counts": {
        "pass": 10
      },
      "tolerance_policy": "structural/harmonization check; see validation rows"
    },
    "STRUCTURAL": {
      "max_abs_relative_error": 0.0,
      "row_count": 10,
      "status_counts": {
        "pass": 10
      },
      "tolerance_policy": "structural/harmonization check; see validation rows"
    }
  },
  "run_id": "pt_population_review_cycle1_d828fc79_seed420987",
  "skip_rows": [
    {
      "check_group": "cross_country",
      "confidence": 0.0,
      "constraint_type": "INFORMATIONAL",
      "country": "PT",
      "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": "SEC_PT_TEST_001"
    },
    {
      "check_group": "cross_country",
      "confidence": 0.0,
      "constraint_type": "INFORMATIONAL",
      "country": "PT",
      "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": "SEC_PT_TEST_002"
    }
  ],
  "status_counts": {
    "pass": 68,
    "skip": 2,
    "warn": 4
  },
  "validation_row_count": 74,
  "warn_rows": [
    {
      "check_group": "marginal",
      "confidence": 0.6,
      "constraint_type": "INFORMATIONAL",
      "country": "PT",
      "distribution_id": "MODEL_FALLBACK_RATE",
      "message": "share of employed persons using fallback_1digit occupation coding",
      "pooling_level": "partially_constrained",
      "relative_error": 1.0,
      "severity": "informational",
      "status": "warn",
      "synthetic_value": 1.0,
      "target_value": 0.0,
      "zone_code": "SEC_PT_TEST_001"
    },
    {
      "check_group": "marginal",
      "confidence": 0.6,
      "constraint_type": "INFORMATIONAL",
      "country": "PT",
      "distribution_id": "MODEL_REGISTRY_PROFILE",
      "message": "registry profile indicates comparable-country dependence",
      "pooling_level": "partially_constrained",
      "relative_error": 0.289,
      "severity": "informational",
      "status": "warn",
      "synthetic_value": 0.289,
      "target_value": 0.0,
      "zone_code": "SEC_PT_TEST_001"
    },
    {
      "check_group": "marginal",
      "confidence": 0.6,
      "constraint_type": "INFORMATIONAL",
      "country": "PT",
      "distribution_id": "MODEL_FALLBACK_RATE",
      "message": "share of employed persons using fallback_1digit occupation coding",
      "pooling_level": "partially_constrained",
      "relative_error": 1.0,
      "severity": "informational",
      "status": "warn",
      "synthetic_value": 1.0,
      "target_value": 0.0,
      "zone_code": "SEC_PT_TEST_002"
    },
    {
      "check_group": "marginal",
      "confidence": 0.6,
      "constraint_type": "INFORMATIONAL",
      "country": "PT",
      "distribution_id": "MODEL_REGISTRY_PROFILE",
      "message": "registry profile indicates comparable-country dependence",
      "pooling_level": "partially_constrained",
      "relative_error": 0.289,
      "severity": "informational",
      "status": "warn",
      "synthetic_value": 0.289,
      "target_value": 0.0,
      "zone_code": "SEC_PT_TEST_002"
    }
  ]
}

household_diagnostics.json

{
  "country": "PT",
  "family_composition_status": "weak_seeded_modelled",
  "household_count": 8,
  "household_role_counts": {
    "reference": 8
  },
  "household_size_counts": {
    "1": 8
  },
  "household_type_age_codebook": {
    "HH_SINGLE_E": {
      "age_max": 120,
      "age_min": 65,
      "label": "single-person elderly household",
      "seeded_birth_date": "1951-06-15"
    },
    "HH_SINGLE_M": {
      "age_max": 64,
      "age_min": 35,
      "label": "single-person middle adult household",
      "seeded_birth_date": "1981-06-15"
    },
    "HH_SINGLE_Y": {
      "age_max": 34,
      "age_min": 18,
      "label": "single-person younger adult household",
      "seeded_birth_date": "2001-06-15"
    }
  },
  "household_type_age_remediations": [
    {
      "age_at_review_reference_date": 74,
      "household_id": 1,
      "household_type": "HH_SINGLE_E",
      "new_birth_date": "1951-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 1
    },
    {
      "age_at_review_reference_date": 74,
      "household_id": 2,
      "household_type": "HH_SINGLE_E",
      "new_birth_date": "1951-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 2
    },
    {
      "age_at_review_reference_date": 44,
      "household_id": 3,
      "household_type": "HH_SINGLE_M",
      "new_birth_date": "1981-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 3
    },
    {
      "age_at_review_reference_date": 44,
      "household_id": 4,
      "household_type": "HH_SINGLE_M",
      "new_birth_date": "1981-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 4
    },
    {
      "age_at_review_reference_date": 24,
      "household_id": 5,
      "household_type": "HH_SINGLE_Y",
      "new_birth_date": "2001-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 5
    },
    {
      "age_at_review_reference_date": 24,
      "household_id": 6,
      "household_type": "HH_SINGLE_Y",
      "new_birth_date": "2001-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 6
    },
    {
      "age_at_review_reference_date": 44,
      "household_id": 7,
      "household_type": "HH_SINGLE_M",
      "new_birth_date": "1981-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 7
    },
    {
      "age_at_review_reference_date": 24,
      "household_id": 8,
      "household_type": "HH_SINGLE_Y",
      "new_birth_date": "2001-06-15",
      "old_birth_date": "1991-06-15",
      "person_id": 8
    }
  ],
  "household_type_age_semantics_status": "explicit_seeded_single_person_age_bands_applied",
  "household_type_counts": {
    "HH_SINGLE_E": 2,
    "HH_SINGLE_M": 3,
    "HH_SINGLE_Y": 3
  },
  "households_without_dwelling": [],
  "notes": [
    "Seeded PT slice currently has 8 one-person households; family-composition review should request richer measured household microstructure before approving broad use.",
    "HH_SINGLE_Y/M/E are explicit seeded single-person age-band labels in this bundle; person birth_date values are set to fall within the stated label bands."
  ],
  "parent_child_age_gap_status": "not_evaluable_no_child_households_in_seeded_PT_slice",
  "person_count": 8,
  "persons_without_household": [],
  "run_id": "pt_population_review_cycle1_d828fc79_seed420987"
}

dwelling_building_diagnostics.json

{
  "assignment_counts": {
    "linked_seeded_cadastro_fixture": 8
  },
  "building_count": 3,
  "building_inventory_report": {
    "artifacts": {
      "buildings_path": "/home/synthestat/output/PT/buildings.parquet",
      "dwellings_path": "/home/synthestat/output/PT/dwellings.parquet"
    },
    "boundary_path": "/home/synthestat/config/buildings/PT/secao_seed.geojson",
    "building_count": 3,
    "capacity_check": {
      "dwelling_count": 8,
      "household_count": 8,
      "ok": true,
      "shortfall": 0
    },
    "country": "PT",
    "dwelling_count": 8,
    "notes": [
      "Seeded PT Task 02 slice built from Cadastro-style seeded building fixtures plus secao-estatistica-style seeded polygons.",
      "This remains a seeded Portugal building-stock slice with heuristic dwelling inference, not a full Cadastro/INE national register integration."
    ],
    "quality_tier": "B2",
    "raw_path": "/home/synthestat/config/buildings/PT/cadastro_seed.json",
    "zone_counts": {
      "SEC_PT_TEST_001": 2,
      "SEC_PT_TEST_002": 1
    }
  },
  "building_quality_tier_counts": {
    "B2": 3
  },
  "capacity_check": {
    "dwelling_count": 8,
    "household_count": 8,
    "ok": true,
    "shortfall": 0
  },
  "caveats": [
    "Dwellings are inferred where observed dwelling counts are absent; building realism is suitable only for internal review of the seeded path."
  ],
  "country": "PT",
  "dwelling_count": 8,
  "dwelling_household_reference_remediations": [
    {
      "dwelling_id": "PT_BLDG_001_dw_1",
      "new_household_id": 1,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_001_dw_2",
      "new_household_id": 2,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_001_dw_3",
      "new_household_id": 3,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_002_dw_1",
      "new_household_id": 4,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_002_dw_2",
      "new_household_id": 5,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_002_dw_3",
      "new_household_id": 6,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_003_dw_1",
      "new_household_id": 7,
      "old_household_id": null
    },
    {
      "dwelling_id": "PT_BLDG_003_dw_2",
      "new_household_id": 8,
      "old_household_id": null
    }
  ],
  "dwelling_status_counts": {
    "inferred": 5,
    "observed": 3
  },
  "household_count": 8,
  "occupied_dwelling_household_reference_status": "populated_from_synthetic_households_dwelling_id_links",
  "occupied_dwellings_without_household_id": [],
  "real_building_status": "seeded_cadastro_style_fixture_not_live_national_register",
  "run_id": "pt_population_review_cycle1_d828fc79_seed420987"
}

distribution_diagnostics.json

{
  "attribute_degeneracy_guardrail": "These diagnostics warn reviewers when tiny seeded/modelled slices emit repeated person attributes; repeated values are not realism claims.",
  "blocking_issues": [],
  "by_constraint_type": {
    "FIRM": 7,
    "GUIDE": 18,
    "HARD": 2,
    "SOFT": 11
  },
  "by_dataset_variant": {
    "comparable_country": 11,
    "current": 1,
    "robust": 26
  },
  "by_finest_geography_status": {
    "constrained": 27,
    "modelled": 11
  },
  "confidence_below_0_7": [
    {
      "catalogue_id": "literature:fr-c01_education_occupation_coupling__transfer_from_fr",
      "confidence": 0.595,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.202,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c02_assortative_mating_education__transfer_from_fr",
      "confidence": 0.605,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c03_assortative_mating_age__transfer_from_fr",
      "confidence": 0.675,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.142,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c04_assortative_mating_origin__transfer_from_fr",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c05_spatial_sorting_education__transfer_from_fr",
      "confidence": 0.695,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.133,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c06_spatial_sorting_income__transfer_from_fr",
      "confidence": 0.695,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.133,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c08_intergenerational_income_elasticity__transfer_from_fr",
      "confidence": 0.575,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.223,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c09_intergenerational_occupation_transmission__transfer_from_fr",
      "confidence": 0.575,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.223,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c10_commuting_mode_distance__transfer_from_fr",
      "confidence": 0.635,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.183,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c11_health_age_sex_education__transfer_from_fr",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.193,
        "method": "literature_regression"
      }
    }
  ],
  "confidence_below_0_7_count": 10,
  "country": "PT",
  "coverage_path": "output/catalogue/distribution_coverage_PT.json",
  "coverage_summary": {
    "country": "PT",
    "covered_count": 38,
    "missing_count": 0,
    "required_count": 38,
    "usable_count": 38,
    "usable_ratio": 1.0
  },
  "modelled_or_transfer_entries": [
    {
      "catalogue_id": "literature:fr-c01_education_occupation_coupling__transfer_from_fr",
      "confidence": 0.595,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.202,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c02_assortative_mating_education__transfer_from_fr",
      "confidence": 0.605,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:f

… truncated after 12,000 characters …

uncertainty_summary.json

{
  "country": "PT",
  "hidden_population_uncertainty_status": "unavailable; no overlays emitted because bounds/evidence are missing in current layer",
  "input_uncertainty_records": [
    {
      "catalogue_id": "literature:fr-c01_education_occupation_coupling__transfer_from_fr",
      "confidence": 0.595,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C01_education_occupation_coupling",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.202,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c02_assortative_mating_education__transfer_from_fr",
      "confidence": 0.605,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C02_assortative_mating_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c03_assortative_mating_age__transfer_from_fr",
      "confidence": 0.675,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C03_assortative_mating_age",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.142,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c04_assortative_mating_origin__transfer_from_fr",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C04_assortative_mating_origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c05_spatial_sorting_education__transfer_from_fr",
      "confidence": 0.695,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C05_spatial_sorting_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.133,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c06_spatial_sorting_income__transfer_from_fr",
      "confidence": 0.695,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C06_spatial_sorting_income",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.133,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c07_spatial_sorting_origin__transfer_from_fr",
      "confidence": 0.715,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C07_spatial_sorting_origin",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.123,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c08_intergenerational_income_elasticity__transfer_from_fr",
      "confidence": 0.575,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C08_intergenerational_income_elasticity",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.223,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c09_intergenerational_occupation_transmission__transfer_from_fr",
      "confidence": 0.575,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C09_intergenerational_occupation_transmission",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.223,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c10_commuting_mode_distance__transfer_from_fr",
      "confidence": 0.635,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C10_commuting_mode_distance",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.183,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c11_health_age_sex_education__transfer_from_fr",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "dataset_variant": "comparable_country",
      "finest_geography_status": "modelled",
      "spec_id": "C11_health_age_sex_education",
      "uncertainty": {
        "bounds_uri": null,
        "credible_level": 0.9,
        "mean_cell_cv": 0.193,
        "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": "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.71,
      "constraint_type": "SOFT",
      "dataset_variant": "robus

… truncated after 12,000 characters …

source_provenance.json

{
  "best_distribution_sources": {
    "D01_demographics_finest": "PT_INE_population",
    "D05_education": "PT_INE_education",
    "D12_household_type": "PT_INE_households",
    "building_stock": "PT_CADASTRO_seeded_buildings",
    "employment_occupation_industry": "PT_INE_employment",
    "geography_boundaries": "PT_INE_section_reference",
    "income": "PT_INE_income"
  },
  "catalogue_sources": {
    "coverage": "output/catalogue/distribution_coverage_PT.json",
    "readiness": "output/catalogue/distribution_readiness_PT.json",
    "registry": "output/catalogue/distribution_registry_PT.json"
  },
  "country": "PT",
  "created_at": "2026-05-19T16:52:41Z",
  "geography_levels": [
    "NUTS-2",
    "NUTS-3",
    "commune",
    "national",
    "unknown"
  ],
  "licence_metadata_status": "seeded/manual source inventory does not integrate licence text or licence URLs for PT sources in this run; source_records mark this explicitly rather than omitting it",
  "live_download": {
    "enabled": false,
    "path": null,
    "summary": null
  },
  "live_probe": {
    "enabled": false,
    "path": null,
    "summary": null
  },
  "manual_sources": [
    "PT_INE_population",
    "PT_INE_households",
    "PT_INE_education",
    "PT_INE_employment",
    "PT_INE_income",
    "PT_INE_section_reference",
    "PT_CADASTRO_seeded_buildings"
  ],
  "quality_flags": {
    "readiness_status": "pass",
    "source_gaps": [
      "Live PT INE probe/download is disabled for this run; no endpoint reachability claims are made.",
      "Building/context fixtures still require dwelling inference; no live Cadastro dwelling integration exists in this repo.",
      "Current Portugal implementation is still a seeded source-inventory slice and not yet a production nationwide extraction pipeline."
    ],
    "warning_issues": []
  },
  "reference_periods": "See registry entries/source catalogue; bundle does not rewrite source periods.",
  "registry_entries": [
    {
      "catalogue_id": "literature:fr-c01_education_occupation_coupling__transfer_from_fr",
      "confidence": 0.595,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.202,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c02_assortative_mating_education__transfer_from_fr",
      "confidence": 0.605,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c03_assortative_mating_age__transfer_from_fr",
      "confidence": 0.675,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.142,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c04_assortative_mating_origin__transfer_from_fr",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.193,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c05_spatial_sorting_education__transfer_from_fr",
      "confidence": 0.695,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.133,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c06_spatial_sorting_income__transfer_from_fr",
      "confidence": 0.695,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.133,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c07_spatial_sorting_origin__transfer_from_fr",
      "confidence": 0.715,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.123,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c08_intergenerational_income_elasticity__transfer_from_fr",
      "confidence": 0.575,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.223,
        "method": "literature_prior"
      }
    },
    {
      "catalogue_id": "literature:fr-c09_intergenerational_occupation_transmission__transfer_from_fr",
      "confidence": 0.575,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.223,
        "method": "literature_regression"
      }
    },
    {
      "catalogue_id": "literature:fr-c10_commuting_mode_distance__transfer_from_fr",
      "confidence": 0.635,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "commune",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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.183,
        "method": "literature_transition"
      }
    },
    {
      "catalogue_id": "literature:fr-c11_health_age_sex_education__transfer_from_fr",
      "confidence": 0.615,
      "constraint_type": "GUIDE",
      "country": "PT",
      "data_uri": "data/literature/seeded_occupation_priors.yaml",
      "dataset_variant": "comparable_country",
      "evidence_quality": "academic_literature",
      "finest_geography_status": "modelled",
      "geo_level": "national",
      "geo_version": "FR_COM_CURRENT",
      "pooling_level": "comparable_country",
      "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": nul

… truncated after 12,000 characters …

unavailable.json

{
  "categories": {
    "homelessness": {
      "reason": "No Portugal small-area measured homelessness distribution with uncertainty bounds is integrated in the current PT synthesis layer.",
      "status": "unavailable"
    },
    "institutional_populations": {
      "reason": "No institutional/group-quarter person layer is integrated for Portugal in the current seeded path.",
      "status": "unavailable"
    },
    "refugees_asylum_seekers": {
      "reason": "No integrated age/sex/household/secao-estatistica or municipality distribution with bounds exists in current PT bundle inputs.",
      "status": "unavailable"
    },
    "students": {
      "reason": "Education status exists only as a modelled person attribute; no separate student-location, school register/capacity, or assignment overlay is available.",
      "status": "unavailable_overlay"
    },
    "syrian_refugees": {
      "reason": "No Portugal-specific small-area measured Syrian refugee source with bounds is integrated; model-only synthesis would violate uncertainty rules.",
      "status": "unavailable"
    },
    "ukrainian_displaced_people": {
      "reason": "Policy-relevant group, but no separate uncertainty-aware Portugal overlay source is wired into the current seeded path.",
      "status": "unavailable"
    },
    "undocumented_seasonal_populations": {
      "reason": "No measured Portugal distribution with uncertainty bounds exists in current repo inputs.",
      "status": "unavailable"
    }
  },
  "country": "PT",
  "created_at": "2026-05-19T16:52:41Z",
  "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": "pt_population_review_cycle1_d828fc79_seed420987"
}