Local run directory: /home/synthestat/output/runs/AD/ad_population_review_cycle1_354c792b_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
7,706
file
constraint_residuals.json
5,016
file
distribution_diagnostics.json
20,392
file
dwelling_building_diagnostics.json
1,644
file
geography_quality_tiers.json
17,117
file
hidden_population_overlays.unavailable.json
3,293
file
household_diagnostics.json
732
file
model_notes.md
3,023
file
source_provenance.json
35,782
file
synthetic_building_assignments.parquet
3,544
file
synthetic_dwellings.parquet
2,400
file
synthetic_households.parquet
2,855
file
synthetic_persons.parquet
5,497
file
unavailable.json
1,903
file
uncertainty_summary.json
17,239
file
work_school_assignments.unavailable.json
897
file
Datasets and distributions
Lists come from the latest run bundle: source_provenance.json, distribution_diagnostics.json, and build_manifest.json.
Summary
Datasets used
10
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
No live Central Statistics Office Andorra retrieval adapter is implemented yet for AD Task 01.
Open building geometry and registry-like context still require dwelling inference; no live Ordnance Survey Andorra dwelling integration exists in this repo.
Current Andorra implementation is seeded and documentation-first, not a production national extraction path.
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
# AD population review bundle — cycle 1
Run ID: `ad_population_review_cycle1_354c792b_seed420987`
Bundle path: `/home/synthestat/output/runs/AD/ad_population_review_cycle1_354c792b_seed420987`
Created at: 2026-05-19T16:47:53Z
Release mode: internal research review.
## What this bundle is
This is the best current AD review bundle that can be produced from the existing Synthestat source/code layer without fabricating precision. It packages the seeded Andorra population slice: 8 synthetic persons in 8 households, linked to 8 seeded/observed-fixture dwellings and 3 Cadastre d’Andorra-style seeded buildings across 2 parròquia-style test zones (PAR_AD_TEST_001, PAR_AD_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.
## Measured/constrained/modelled/unknown separation
- Measured/constrained: seeded D01/D05/D12-style demographic/education/household constraints in the existing AD registry/validation artifacts, exactly as listed in provenance and diagnostics.
- Modelled/transfer: correlational, fine occupation/industry, income, migration, fertility, health, and comparable-country GUIDE/SOFT priors; uncertainty records are listed in `uncertainty_summary.json` and `source_provenance.json`.
- Unknown/unavailable: hidden-population overlays, work/school/facility assignments, live national cadastre/building-register linkage, cross-border/seasonal overlays, and nationwide parròquia coverage.
## Uncertainty and unavailable 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 AD 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 AD 1:1 synthesis.
- Current finest supported geography is seeded parròquia-style test zones, not all Andorran parròquies.
- Building/dwelling realism is a Cadastre-style seeded fixture, not live national cadastre assignment.
- Occupation/industry and cross-border work/school allocation at fine geography are modelled/unavailable and must remain flagged.
- No live Departament d’Estadística d’Andorra or cadastre retrieval adapter is implemented; current bundle relies on existing seeded/manual catalogue artifacts.
## Expected routing
The bundle is contract-complete for synth-reviewer inspection. Because scope is intentionally seeded and several layers are unavailable, likely routing should be either EVIDENCE_EXHAUSTED_HUMAN_REVIEW or MODEL_IMPROVEMENT_EXHAUSTED_HUMAN_REVIEW unless reviewer finds a contract violation.
build_manifest.json
{
"assignment_scope": {
"dwelling_building": "available_seeded",
"facility": "unavailable",
"school": "unavailable",
"work": "unavailable"
},
"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": "AD",
"created_at": "2026-05-19T16:47:53Z",
"geography_version": {
"seeded_test_zones": [
"PAR_AD_TEST_001",
"PAR_AD_TEST_002"
],
"target": "AD_PARROQUIA_SEEDED_REVIEW"
},
"git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba-dirty",
"git_dirty": true,
"hard_constraint_status": "pass_exact",
"hidden_population_scope": {
"homelessness": {
"reason": "No AD small-area measured homelessness distribution with uncertainty bounds is integrated in the current source layer.",
"status": "unavailable"
},
"institutional_populations": {
"reason": "No AD institution/group-quarter person layer is integrated in the current seeded path.",
"status": "unavailable"
},
"refugees_asylum_seekers": {
"reason": "No integrated AD age/sex/household/parròquia distribution with uncertainty bounds is available in current inputs.",
"status": "unavailable"
},
"students": {
"reason": "Education is a synthetic/modelled person attribute only; no separate student-location/school/institution overlay is integrated.",
"status": "unavailable_overlay"
},
"syrian_refugees": {
"reason": "No AD-specific small-area measured source with bounds integrated; model-only synthesis would be invalid without uncertainty.",
"status": "unavailable"
},
"ukrainian_displaced_people": {
"reason": "Policy-relevant group, but no separate uncertainty-aware small-area overlay source is wired into the AD seeded path.",
"status": "unavailable"
},
"undocumented_seasonal_populations": {
"reason": "No measured AD distribution with uncertainty bounds in current repository inputs; cross-border/seasonal labour is not silently absorbed into de jure households.",
"status": "unavailable"
}
},
"hierarchical_model_report": {
"country": "AD",
"evidence_depth": "well_constrained",
"inputs": {
"manifest_summary_path": "output/AD/manifest_summary.json",
"registry_assembly_report_path": "output/AD/registry_assembly_report.json"
},
"model_path": "output/AD/hierarchical_model.json",
"quality_tier": "A",
"readiness_status": "pass",
"zone_prediction_count": 2,
"zone_predictions_path": "output/AD/zone_predictions_registry.json"
},
"known_limitations": [
"Small seeded AD review slice only: 2 parròquia-style test zones, 8 persons/households; not nationwide 1:1 Andorra synthesis.",
"No live Departament d’Estadística d’Andorra retrieval adapter is implemented; no silent promotion to production evidence.",
"Buildings are Cadastre d’Andorra-style seeded fixtures; this is not full national cadastre/building-register integration.",
"Hidden populations and work/school assignments unavailable rather than modelled without bounds.",
"Fine occupation/detail at parròquia/test-zone geography is modelled; ISCO-3 unavailable and flagged as fallback_1digit.",
"Cross-border/seasonal populations are not silently folded into de jure household constraints."
],
"population_counts": {
"buildings": 3,
"dwellings": 8,
"households": 8,
"persons": 8
},
"population_synthesis_report": {
"completed_zone_count": 2,
"completed_zones": [
"PAR_AD_TEST_001",
"PAR_AD_TEST_002"
],
"consistency": {
"matches_completed_manifest_zones": true,
"prediction_zone_codes": [
"PAR_AD_TEST_001",
"PAR_AD_TEST_002"
]
},
"country": "AD",
"hierarchical_model_path": "output/AD/hierarchical_model.json",
"household_count": 8,
"notes": [
"Seeded AD Task 05 slice assembled from completed seeded zone outputs.",
"This is a small seeded Andorra synthesis slice, not broad French population synthesis."
],
"person_count": 8,
"source_manifest_summary_path": "output/AD/manifest_summary.json",
"zone_household_counts": {
"PAR_AD_TEST_001": 5,
"PAR_AD_TEST_002": 3
},
"zone_person_counts": {
"PAR_AD_TEST_001": 5,
"PAR_AD_TEST_002": 3
},
"zone_prediction_count": 2,
"zone_predictions_path": "output/AD/zone_predictions_registry.json"
},
"project_root": "/home/synthestat",
"random_seed": 420987,
"release_mode": "internal_research_review",
"run_id": "ad_population_review_cycle1_354c792b_seed420987",
"source_catalogue_version": {
"readiness_status": "pass",
"registry": "output/catalogue/distribution_registry_AD.json",
"source_inventory_report": "output/AD/source_inventory_report.json"
},
"validation_slice_report": {
"completed_zone_count": 2,
"completed_zones": [
"PAR_AD_TEST_001",
"PAR_AD_TEST_002"
],
"country": "AD",
"degraded_zone_count": 0,
"manifest_summary_path": "output/AD/manifest_summary.json",
"notes": [
"Aggregated root validation from completed seeded AD zone outputs through INFRA-05.",
"Seeded AD scope is complete through INFRA-05 only; cross-border review outputs are follow-on artifacts."
],
"population_synthesis_report_path": "output/AD/population_synthesis_report.json",
"seeded_scope_completed_through": "INFRA-05",
"synthesis_log_path": "output/AD/synthesis_log.yaml",
"validation_framework_status": "complete_for_seeded_slice",
"validation_report_html_path": "output/AD/validation_report.html",
"validation_report_parquet_path": "output/AD/validation_report.parquet",
"validation_row_count": 74,
"validation_rows_by_zone": {
"PAR_AD_TEST_001": 37,
"PAR_AD_TEST_002": 37
}
},
"zones_degraded": []
}
{
"categories": {
"homelessness": {
"reason": "No AD small-area measured homelessness distribution with uncertainty bounds is integrated in the current source layer.",
"status": "unavailable"
},
"institutional_populations": {
"reason": "No AD institution/group-quarter person layer is integrated in the current seeded path.",
"status": "unavailable"
},
"refugees_asylum_seekers": {
"reason": "No integrated AD age/sex/household/parròquia distribution with uncertainty bounds is available in current inputs.",
"status": "unavailable"
},
"students": {
"reason": "Education is a synthetic/modelled person attribute only; no separate student-location/school/institution overlay is integrated.",
"status": "unavailable_overlay"
},
"syrian_refugees": {
"reason": "No AD-specific small-area measured source with bounds integrated; model-only synthesis would be invalid without uncertainty.",
"status": "unavailable"
},
"ukrainian_displaced_people": {
"reason": "Policy-relevant group, but no separate uncertainty-aware small-area overlay source is wired into the AD seeded path.",
"status": "unavailable"
},
"undocumented_seasonal_populations": {
"reason": "No measured AD distribution with uncertainty bounds in current repository inputs; cross-border/seasonal labour is not silently absorbed into de jure households.",
"status": "unavailable"
}
},
"country": "AD",
"created_at": "2026-05-19T16:47:53Z",
"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": "ad_population_review_cycle1_354c792b_seed420987"
}