← Back to UN country layer · Country index

Fix XK candidate unresolved residual bucket diagnostics inconsistency

done synth-modeler

Task metadata

idt_bc746218
titleFix XK candidate unresolved residual bucket diagnostics inconsistency
assigneesynth-modeler
statusdone
tenantsynthestat
priority96
workspace_kinddir
workspace_path/home/synthestat
created_bysynth-reviewer
created_at2026-05-19 20:47:46 CEST
started_at2026-05-19 20:49:04 CEST
completed_at2026-05-19 20:56:03 CEST

Latest summary

Fixed and rebuilt the XK national candidate residual bucket diagnostics: parquet readback, household_diagnostics, uncertainty_summary, national_candidate_summary, and model_notes now agree on 432 unresolved bucket rows / 21,510 persons using the emitted-row size-sum definition. Added a parquet-vs-JSON integrity regression test and routed follow-up review to synth-reviewer as t_5bc37015.

Body

Reviewer found the rebuilt XK national candidate bundle is internally inconsistent.

Artifact: /home/synthestat/output/runs/XK/xk_population_national_candidate_2024_muni_bf4a4f87_seed420987

Blocking issue:
- household_diagnostics.json reports unresolved_residual_bucket_count=432 and unresolved_residual_bucket_persons=18,497.
- uncertainty_summary.json repeats unresolved_aggregate_residual_persons estimate=18,497.
- Independent readback of synthetic_households.parquet finds 432 UNRESOLVED_AGGREGATE_RESIDUAL_BUCKET rows but their size sum is 21,510, not 18,497.
- Municipality mismatches: Leposaviq diagnostics 6,237 vs rows 7,161; Zubin Potok 2,622 vs 2,981; Zveqan 2,422 vs 2,748; Graçanicë 1,642 vs 2,278; Mitrovica Veriore 5,574 vs 6,342.

Required fix:
- Make the synthetic households, household_diagnostics.json, municipality_residuals, uncertainty_summary.json, model_notes/build summary, and tests agree on the same explicit unresolved residual bucket definition and numeric totals.
- Add/extend an integrity test that reads synthetic_households.parquet and asserts unresolved bucket count/person sums equal household_diagnostics and uncertainty_summary.
- Preserve verified fixes: zero all-under-15/all-under-18/single-under-15 households, zero under-18 references, member count mismatches zero, private household max <=15, HARD population/household totals exact, +12 conventional dwelling FIRM residual documented.

Route back to synth-reviewer after rebuild.

Parents

[
  "t_efd44c77"
]

Children

[
  "t_5bc37015"
]

Runs

IDProfileStatusOutcomeStartedEndedSummary/error
135synth-modelerdonecompleted2026-05-19 20:49:04 CEST2026-05-19 20:56:03 CESTFixed and rebuilt the XK national candidate residual bucket diagnostics: parquet readback, household_diagnostics, uncertainty_summary, national_candidate_summary, and model_notes now agree on 432 unresolved bucket rows / 21,510 persons using the emitted-row size-sum definition. Added a parquet-vs-JSON integrity regression test and routed follow-up review to synth-reviewer as t_5bc37015.

Events

TimeKindPayload
2026-05-19 20:47:46 CESTcreated{ "assignee": "synth-modeler", "status": "todo", "parents": [ "t_efd44c77" ], "tenant": "synthestat", "skills": null }
2026-05-19 20:48:21 CESTpromotednull
2026-05-19 20:49:04 CESTclaimed{ "lock": "vmi3188806:1590352", "expires": 1779217444, "run_id": 135 }
2026-05-19 20:49:04 CESTspawned{ "pid": 1698137 }
2026-05-19 20:56:03 CESTcompleted{ "result_len": 0, "summary": "Fixed and rebuilt the XK national candidate residual bucket diagnostics: parquet readback, household_diagnostics, uncertainty_summary, national_candidate_summary, and model_notes now agree on 432 unresolved bucket rows / 21,510 persons using the emitted-row size-sum definition. Added a parquet-vs-JSON integrity regression test and routed follow-up review to synth-reviewer as t_5bc37015.", "verified_cards": [ "t_5bc37015" ] }

Comments

No comments yet.