# LV national population review candidate
Run: `lv_population_review_national_candidate_2025_csb_freeze_44d91be2_seed420987`
Created: 2026-05-19T19:21:49Z
This is a non-fixture national-scale Latvia candidate built from the frozen CSB PxWeb population-QA payloads under `/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze`. It replaces the existing 8-person/8-household seeded LV slice for reviewer inspection; the seeded slice remains explicitly non-national.
## Row counts versus official controls
- Persons: 1,860,565 rows vs LV_CSP_IRD041 2025 all-resident population target 1,860,565; residual 0.
- Households: 843,907 rows vs LV_CSP_MVS041 2025 private-household target 843,907; residual 0.
- Private-household population: candidate assigns 1,860,565 persons into households vs LV_CSP_MVS041 private-household population 1,833,782; residual 26,783 (1.4605%). This is an explicit FIRM relaxation to avoid dropping all-resident HARD population or emitting hidden-population person labels without reviewed overlay evidence.
## Quality notes
- HARD national all-resident age-sex controls are exact.
- HARD/FIRM household count is exact.
- Household type, education, employment, occupation, industry, income, and household roles are model-driven and flagged with evidence/quality fields.
- Household realism guardrails are enforced in `household_diagnostics.json`: zero minor-only private households, zero under-15/no-adult households, zero reference persons under 25, and zero child-family households lacking a child member under 25 after incompatible type/size shells are downgraded to plausible non-child household types.
- No hidden-population person labels are emitted.
- Dwellings are modelled shells and building/work/school assignments are unavailable, not fabricated.
Reviewer should inspect `constraint_residuals.json`, `distribution_diagnostics.json`, `uncertainty_summary.json`, and the Parquet row counts before accepting this as a candidate.
build_manifest.json
{
"artifact_counts": {
"dwellings": 843907,
"households": 843907,
"persons": 1860565
},
"assignment_scope": {
"building_assignment": "unavailable",
"work_school_assignment": "unavailable"
},
"classification_crosswalk_versions": {
"education": "ISCED-2011 project standard modelled",
"industry": "NACE Rev.2 1-digit fallback modelled",
"occupation": "ISCO-08 1-digit fallback modelled"
},
"constraints_relaxed": [
{
"actual": 1860565,
"constraint": "population living in private households",
"reason": "all-resident HARD population reconciled with private-household HARD row count; non-private resident residual has no current person-level allocation evidence in frozen payloads",
"relative_residual": 0.014605334767164253,
"residual": 26783,
"source_id": "LV_CSP_MVS041",
"status": "relaxed_warn",
"target": 1833782
},
{
"actual": 843907,
"constraint": "occupied conventional dwellings historical 2021 guide",
"residual": 32915,
"source_id": "LV_CSP_MAS010",
"status": "guide_only",
"target": 810992
}
],
"constraints_used": [
"LV_CSP_IRD041 HARD all-resident national age-sex",
"LV_CSP_MVS041 HARD/FIRM household size/count and private-household population",
"LV_CSP_MVS031 FIRM household type composition",
"LV_CSP_MAS010 GUIDE dwellings/collective-living historical baseline"
],
"country": "LV",
"created_at": "2026-05-19T19:21:49Z",
"geography_version": "LV national 2025 country-level controls from CSB PxWeb freeze",
"git_commit": "a5ad12d74bcf64a2c256e1fe83d99cc700e02bba-dirty",
"git_dirty": true,
"hidden_population_scope": {
"note": "no hidden-population person labels emitted",
"status": "not_person_labelled",
"unavailable_file": "hidden_population_overlays_unavailable.json"
},
"known_limitations": [
"National candidate only: no fine-geography person allocation in this bundle.",
"Household microstructure is deterministic/modelled; no person-level register microdata were available.",
"Private-household-population target relaxed by all-resident/private-household residual to preserve exact all-resident HARD population and household-row targets.",
"Dwellings are modelled shells; no building assignment is claimed."
],
"project_root": "/home/synthestat",
"random_seed": 420987,
"review_status": "REQUEST_REVIEW",
"run_id": "lv_population_review_national_candidate_2025_csb_freeze_44d91be2_seed420987",
"source_catalogue_version": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/lv_csb_pxweb_population_qa_effective_catalogue.json",
"zones_degraded": []
}
constraint_residuals.json
{
"firm_constraints": [
{
"actual": 1860565,
"constraint": "population living in private households",
"reason": "all-resident HARD population reconciled with private-household HARD row count; non-private resident residual has no current person-level allocation evidence in frozen payloads",
"relative_residual": 0.014605334767164253,
"residual": 26783,
"source_id": "LV_CSP_MVS041",
"status": "relaxed_warn",
"target": 1833782
},
{
"actual": 843907,
"constraint": "occupied conventional dwellings historical 2021 guide",
"residual": 32915,
"source_id": "LV_CSP_MAS010",
"status": "guide_only",
"target": 810992
}
],
"hard_constraints": [
{
"actual": 1860565,
"constraint": "national all-resident age-sex population rows",
"residual": 0,
"source_id": "LV_CSP_IRD041",
"status": "pass",
"target": 1860565
},
{
"actual": 843907,
"constraint": "national private household row count",
"residual": 0,
"source_id": "LV_CSP_MVS041",
"status": "pass",
"target": 843907
}
],
"soft_guide_notes": [
"Household type and non-core attributes are national-modelled from frozen LV sources and comparable-country fallback; they are not fine-geography measured microdata.",
"No hidden-population person labels are emitted. The all-resident/private-household residual is documented as a constraint relaxation rather than assigning hidden categories to individuals."
],
"status": "PASS_WITH_DOCUMENTED_RELAXATION"
}
{
"building_assignment_reason": "No current LV building-level runtime artifact was provided in parent frozen source closure; dwellings are national modelled shells only.",
"building_assignment_status": "unavailable",
"dwelling_rows": 843907,
"dwelling_target_2021_guide": 810992,
"quality_tier": "C"
}
distribution_diagnostics.json
{
"country": "LV",
"dwelling_count": 843907,
"household_count": 843907,
"household_realism_checks": {
"child_family_households": 181494,
"child_family_households_with_child_members": 181494,
"child_family_households_without_child_members": 0,
"minor_only_households": 0,
"reference_person_under15": 0,
"reference_person_under18": 0,
"reference_person_under25": 0,
"role_counts": {
"child": 456389,
"other_household_member": 248116,
"partner": 312153,
"reference_person": 843907
},
"under15_no_adult_households": 0
},
"max_household_size": 12,
"official_targets": {
"all_resident_population_2025_LV_CSP_IRD041": 1860565,
"collective_living_quarters_persons_2021_LV_CSP_MAS010": 19276,
"occupied_conventional_dwellings_2021_LV_CSP_MAS010": 810992,
"private_household_population_2025_LV_CSP_MVS041": 1833782,
"private_households_2025_LV_CSP_MVS041": 843907
},
"person_count": 1860565,
"residuals": {
"firm_constraints": [
{
"actual": 1860565,
"constraint": "population living in private households",
"reason": "all-resident HARD population reconciled with private-household HARD row count; non-private resident residual has no current person-level allocation evidence in frozen payloads",
"relative_residual": 0.014605334767164253,
"residual": 26783,
"source_id": "LV_CSP_MVS041",
"status": "relaxed_warn",
"target": 1833782
},
{
"actual": 843907,
"constraint": "occupied conventional dwellings historical 2021 guide",
"residual": 32915,
"source_id": "LV_CSP_MAS010",
"status": "guide_only",
"target": 810992
}
],
"hard_constraints": [
{
"actual": 1860565,
"constraint": "national all-resident age-sex population rows",
"residual": 0,
"source_id": "LV_CSP_IRD041",
"status": "pass",
"target": 1860565
},
{
"actual": 843907,
"constraint": "national private household row count",
"residual": 0,
"source_id": "LV_CSP_MVS041",
"status": "pass",
"target": 843907
}
],
"soft_guide_notes": [
"Household type and non-core attributes are national-modelled from frozen LV sources and comparable-country fallback; they are not fine-geography measured microdata.",
"No hidden-population person labels are emitted. The all-resident/private-household residual is documented as a constraint relaxation rather than assigning hidden categories to individuals."
],
"status": "PASS_WITH_DOCUMENTED_RELAXATION"
},
"role_counts": {
"child": 456389,
"other_household_member": 248116,
"partner": 312153,
"reference_person": 843907
},
"run_id": "lv_population_review_national_candidate_2025_csb_freeze_44d91be2_seed420987"
}
{
"country": "LV",
"retrieval_freeze_root": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze",
"source_freeze_catalogue": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/lv_csb_pxweb_population_qa_effective_catalogue.json",
"source_freeze_catalogue_sha256": "5dd3d9990a4b0f8cbe1d085002ba6e7304a89655f632118e7a610cae91d9562f",
"sources": [
{
"constraint_precedence": "HARD",
"data_checksum_sha256": "12483a93ad2c3c59562a1f58a556cf9d3f23dacb9ec55a635752c25d6c351bdc",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_CSP_IRD041/LV_CSP_IRD041_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "HARD national population age-sex controls",
"source_id": "LV_CSP_IRD041",
"title": "Population in regions, State cities and municipalities by age and gender at the beginning of the year by Territorial unit, Age, Sex and Time period"
},
{
"constraint_precedence": "FIRM/HARD",
"data_checksum_sha256": "56a2c04ab6f99198ad6e05495c950860f47c8b7cc93a8fbfbf962362bd914c6c",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_CSP_MVS031/LV_CSP_MVS031_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "private-household type controls",
"source_id": "LV_CSP_MVS031",
"title": "Population and households by type of private household in regions, State cities and municipalities at the beginning of year by Territorial unit, Household's type, Unit and Time period"
},
{
"constraint_precedence": "FIRM/HARD",
"data_checksum_sha256": "0e0bace265037f7f4fcaf8acdc467cd879f86a2ca4abeb106e4a495e1a0dd28c",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_CSP_MVS041/LV_CSP_MVS041_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "private-household size controls",
"source_id": "LV_CSP_MVS041",
"title": "Population and households by size of private household in regions, State cities and municipalities at the beginning of year by Territorial unit, Size of private household, Unit and Time period"
},
{
"constraint_precedence": "FIRM",
"data_checksum_sha256": "6274ca7125db7e04d192d2bbe62847613e37aaf2ab664094b9704347e1508005",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_CSP_MVS011/LV_CSP_MVS011_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "rounded household count and household-population cross-check",
"source_id": "LV_CSP_MVS011",
"title": "Total number and average size of private households in regions, State cities, municipalities, urban and rural areas at the beginning of year by Territorial unit, Unit and Time period"
},
{
"constraint_precedence": "GUIDE/SOFT",
"data_checksum_sha256": "0621f827dff3fff897063bec9e93ca4e34a441cbfee7c1b94b30cb868ac225e2",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_CSP_MAS010/LV_CSP_MAS010_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2021",
"role": "Census 2021 living quarters/dwellings/group quarters baseline",
"source_id": "LV_CSP_MAS010",
"title": "Living quarters and persons living in them in regions, cities, municipalities and neighbourhoods by Territorial unit, Type of living quarter, Unit and Time period"
},
{
"constraint_precedence": "GUIDE",
"data_checksum_sha256": "774025161eaf483b958f7fab3a7153e55cd98a6f89a75376480b8c6a89b286c5",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_CSP_IRV090/LV_CSP_IRV090_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "Ukrainian refugee overlay candidate",
"source_id": "LV_CSP_IRV090",
"title": "Refugees from Ukraine in regions, State cities and municipalities at the beginning of year by Territorial unit and Time period"
},
{
"constraint_precedence": "FIRM/SOFT",
"data_checksum_sha256": "7d454deacbf0e06f8319d696a47c4aaaf884d26588fc9fff69ecf00451f705eb",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_OSP_PUB_IRV071/LV_OSP_PUB_IRV071_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "country-of-birth/origin fine geography prior",
"source_id": "LV_OSP_PUB_IRV071",
"title": "Population by sex and country of birth in regions, cities, municipalities, towns, neighbourhoods and densely populated areas at beginning of year by Sex, Country of birth, Territorial unit and Time period"
},
{
"constraint_precedence": "FIRM/SOFT",
"data_checksum_sha256": "4e0af704fb4deeb864f0d16cc5f4fb68bca4deddd8fb80150545f51dfdd253b9",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_OSP_PUB_EKA061/LV_OSP_PUB_EKA061_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "major occupation x sex finer geography",
"source_id": "LV_OSP_PUB_EKA061",
"title": "Population aged 15 and over by occupation and gender in regions, cities, municipalities, towns and rural territories at the beginning of the year by Territorial unit, Sex, Occupation and Time period"
},
{
"constraint_precedence": "FIRM",
"data_checksum_sha256": "b9960954806489e5f09dafc8a1814e5e20c253da7567eb9836cdcabd733cf5f2",
"data_path": "/home/synthestat/data/raw/LV/csb_pxweb/2026-05-19_183342Z_population_qa_freeze/LV_OSP_PUB_IZT041/LV_OSP_PUB_IZT041_data.json",
"freeze_status": "frozen_single_payload",
"latest_reference_period": "2025",
"role": "education marginal age 15+",
"source_id": "LV_OSP_PUB_IZT041",
"title": "Population aged 15 and over by educational attainment group in regions, State cities, municipalities, towns, rural territories, neighbourhoods and densely populated areas, at the beginning of year by Education level, Territorial unit and Time period"
}
]
}