# CZ national LKOD population synthesis notes
Run `cz_population_national_lkod_535cfa69_seed420987` emits a CZSO/LKOD registry-aware national path beyond the old 8-person fixture. It writes 10,524,167 synthetic persons and 4,813,103 households across 6,254 obec controls. HARD national population target status: pass_exact with difference 0.
Unavailable layers are explicit: hidden population overlays, work/school/facility assignments, and real dwelling/building assignment are not synthesized without bounded evidence. Fine occupation/industry/education attributes are placeholder unavailable/modelled flags, not measured small-area facts.
build_manifest.json
{
"assignment_scope": {
"dwelling_building_assignments": {
"reason": "National RUIAN dwelling/building linkage is not yet integrated; household dwelling_id is a synthetic obec placeholder.",
"status": "unavailable"
},
"facility_assignments": {
"reason": "UZIS facility evidence is catalogued but not assigned to persons in this runner.",
"status": "unavailable"
},
"school_assignments": {
"reason": "School register evidence is route-level only in the frozen bundle for this path.",
"status": "unavailable"
},
"work_assignments": {
"reason": "Commuting/facility rows are not integrated into bounded assignment layers in this runner.",
"status": "unavailable"
}
},
"classification_crosswalk_versions": {
"education": "not_applied_in_this_runner",
"industry": "not_applied_in_this_runner",
"occupation": "not_applied_in_this_runner"
},
"constraints_relaxed": [],
"constraints_used": [
{
"constraint_precedence": "HARD",
"difference": 0,
"official_population_target": 10524167,
"source_id": "sldb2021_vek1_pohlavi",
"status": "pass_exact",
"synthetic_person_count": 10524167
},
{
"constraint_precedence": "FIRM",
"difference": 0,
"official_household_target": 4813103,
"source_id": "sldb2021_domacnosti_clenu_typ",
"status": "pass_exact",
"synthetic_household_count": 4813103
}
],
"country": "CZ",
"created_at": "2026-05-19T17:59:54Z",
"geography_version": "cz_czso_geography_audit_latest.json + CZSO LKOD obec controls",
"git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba+dirty",
"hidden_population_scope": {
"reason": "No bounded CZ hidden-population evidence integrated in this national runner.",
"status": "unavailable"
},
"input_manifest": {
"controls_path": "output/CZ/czso_lkod_obec_controls.parquet",
"country": "CZ",
"geography_level": "obec",
"mode": "czso_lkod_registry_aware_national",
"provenance": {
"household_controls_source_id": "sldb2021_domacnosti_clenu_typ",
"municipality_controls_source_id": "sldb2021_pocty_clenu_typ",
"national_population_source_id": "sldb2021_vek1_pohlavi",
"retrieval_timestamp_utc": "2026-05-19T16:52:41Z",
"source_records": {
"sldb2021_domacnosti_clenu_typ": {
"data_path": "/home/synthestat/data/ingestion/cz/official_sources/2026-05-19_1849_cz_official_sources/czso_lkod/sldb2021_domacnosti_clenu_typ/sldb2021_domacnosti_clenu_typ_dist0.csv",
"data_sha256": "c813712e6015a15649db83a7bdd9b163e6176d9024eed41219011bfd05da0d14",
"dataset_id": "sldb2021_domacnosti_clenu_typ",
"distribution_url": "https://csu.gov.cz/docs/107508/05638b19-13ea-2ecf-f097-608a80e053eb/sldb2021_domacnosti_clenu_typ.csv",
"metadata_url": "https://vdb.czso.cz/pll/eweb/lkod_ld.datova_sada?id=sldb2021_domacnosti_clenu_typ",
"quality_flags": [],
"reference_period": {
"konec": "2021-03-26",
"typ": "Časový interval",
"začátek": "2021-03-26"
},
"retrieval_timestamp_utc": "2026-05-19T16:52:41Z"
},
"sldb2021_pocty_clenu_typ": {
"data_path": "/home/synthestat/data/ingestion/cz/official_sources/2026-05-19_1849_cz_official_sources/czso_lkod/sldb2021_pocty_clenu_typ/sldb2021_pocty_clenu_typ_dist0.csv",
"data_sha256": "1a05da94cb4f6bde804f643e245c43bf1dde9055467d6078ea146d0b60a34fe3",
"dataset_id": "sldb2021_pocty_clenu_typ",
"distribution_url": "https://csu.gov.cz/docs/107508/c73bf1a8-cb24-43b1-2be8-c10b35f48b96/sldb2021_pocty_clenu_typ.csv",
"metadata_url": "https://vdb.czso.cz/pll/eweb/lkod_ld.datova_sada?id=sldb2021_pocty_clenu_typ",
"quality_flags": [],
"reference_period": {
"konec": "2021-03-26",
"typ": "Časový interval",
"začátek": "2021-03-26"
},
"retrieval_timestamp_utc": "2026-05-19T16:52:41Z"
},
"sldb2021_vek1_pohlavi": {
"data_path": "/home/synthestat/data/ingestion/cz/official_sources/2026-05-19_1849_cz_official_sources/czso_lkod/sldb2021_vek1_pohlavi/sldb2021_vek1_pohlavi_dist0.csv",
"data_sha256": "b364f4eeba730a2bf35fa7958ac93ae146e65395ac62e06e32bf820f3f008409",
"dataset_id": "sldb2021_vek1_pohlavi",
"distribution_url": "https://csu.gov.cz/docs/107508/2a435746-ada6-36ff-88ab-0773089ddd27/sldb2021_vek1_pohlavi.csv",
"metadata_url": "https://vdb.czso.cz/pll/eweb/lkod_ld.datova_sada?id=sldb2021_vek1_pohlavi",
"quality_flags": [],
"reference_period": {
"konec": "2021-03-26",
"typ": "Časový interval",
"začátek": "2021-03-26"
},
"retrieval_timestamp_utc": "2026-05-19T16:52:41Z"
}
}
},
"source_ids": [
"sldb2021_domacnosti_clenu_typ",
"sldb2021_pocty_clenu_typ",
"sldb2021_vek1_pohlavi"
],
"zone_count": 6254
},
"known_limitations": [
"Registry-aware CZ national path generated from frozen CZSO LKOD official records with explicit obec filtering.",
"The previous two-zone building fixture is guarded against being reported as a national PASS.",
"Fine occupation, industry, hidden-population, work/school, facility, and real building-assignment layers remain unavailable unless bounded evidence is integrated.",
"Persons and households satisfy national/obec controls but non-demographic attributes are placeholder unavailable/modelled flags."
],
"project_root": "/home/synthestat",
"random_seed": 420987,
"run_id": "cz_population_national_lkod_535cfa69_seed420987",
"source_catalogue_version": "cz_official_sources_catalogue_latest.json",
"zones_degraded": []
}
{
"country": "CZ",
"household_assignment_status": "synthetic_obec_placeholder_dwellings",
"household_count": 4813103,
"municipality_count": 6254,
"notes": [
"Household counts match CZSO LKOD obec household controls exactly; household composition is size-distributed from population/household totals and remains modelled."
],
"person_count": 10524167,
"run_id": "cz_population_national_lkod_535cfa69_seed420987"
}
dwelling_building_diagnostics.json
{
"country": "CZ",
"reason": "National RUIAN dwelling/building linkage is not yet integrated; household dwelling_id is a synthetic obec placeholder.",
"run_id": "cz_population_national_lkod_535cfa69_seed420987",
"status": "unavailable"
}
{
"bounds_status": "HARD national population exact; FIRM household controls exact; assignment/hidden layers unavailable rather than modelled without bounds.",
"controls_uncertainty": {
"bounds_status": "deterministic HARD/FIRM control satisfaction; non-demographic attributes carry unavailable/modelled flags",
"municipality_population_allocation": "Obec member controls are scaled to the national usual-residence HARD total where summed household-member controls differ from the national people table.",
"occupation_industry": "not generated at fine geography; remains model-driven/unavailable rather than silently inferred"
},
"country": "CZ",
"run_id": "cz_population_national_lkod_535cfa69_seed420987",
"uncertainty_policy": "Uncertainty/provenance are explicit; non-demographic attributes and unavailable layers are not presented as measured."
}