Skip to main content
STRIPED DONKEYWe do the heavy lifting.

Lagos · People & society

Households.
Explore household structure and membership.

Explore household types, where households form and the dates that give those relationships context.

Public sample available

Published domain facts

Households
6,851,685
Current household members
24,123,647
Avg. household size
3.52
Lifecycle events
4,412,712

Overview

Known limits

Household size remains below the cited reference. Lifecycle fixes and remarriage are documented; exact assignment methods remain internal. The guide reports an ungenerated Patient household relationship. Households are synthetic, not civil records.

Review the source limits →
Full scope reference 2 documented sections
Published domain scope.

Published domain scope.

Track household formation, membership and family changes through time. Households share the Demographics data structure and persistent citizen identities.

  • Compare household types across wards
  • Inspect formation dates and dissolution status
  • Review the scope of membership histories
Households
6,851,685
Current household members
24,123,647
Avg. household size
3.52
Lifecycle events
4,412,712
Domain scope.

Domain scope.

Inspect the published scope and deployment boundaries.

Read the published detail

The household generated at the beginning of the city is not necessarily the household the citizen belongs to today. FCTE models formation, marriage, departure, childbirth, widowhood, divorce and remarriage as changing relationships between the same persistent synthetic citizens — not as static groupings assigned once and left alone.

Households live inside Demographics' own data structure (Household / HouseholdMember) — this page documents them on their own because the lifecycle is the story, not because they're a separate engine domain.

Lagos City Twin™ · 1940–2026

Samples & fields

Published sample records.

Household membership sample · rows and field definitions

Household membership sample

Household codeHousehold typeWard nameFormation dateHead nameHead join dateCurrent member countHistorical departures
LOS-HH-211477NuclearTrade-Fair1953-12-27Deola Alara1991-05-2841
LOS-HH-338678ExtendedGberigbe1943-03-17Uchenna Innocent Onwukwe1958-10-2570
LOS-HH-428073NuclearCommand1940-04-23Yinka Lawal1986-03-0920

Showing 3 of 100 sample rows and 8 of 44 fields. “Not recorded” is a display label; downloads retain original values.

Published field definitions · 8 visible fields

Household code

The supplied household code.

Original field: HouseholdCode
Example: LOS-HH-211477

Household type

The recorded household structure.

Original field: HouseholdType
Example: Nuclear

Ward name

The supplied ward name.

Original field: WardName
Example: Trade-Fair

Formation date

The supplied household formation date.

Original field: FormationDate
Example: 1953-12-27

Head name

The supplied name of the current household head.

Original field: HeadName
Example: Deola Alara

Head join date

The join date supplied for the current head; no earlier membership events are inferred.

Original field: HeadJoinDate
Example: 1991-05-28

Current member count

The supplied count of current members.

Original field: CurrentMemberCount
Example: 4

Historical departures

The supplied total of historical departures; individual departure dates are not included.

Original field: HistoricalDepartures
Example: 1

Complete published field dictionary · 44 fields
HouseholdIdHousehold reference
The supplied identifier of this household.Example: 211477
HouseholdCodeHousehold code
The supplied household code.Example: LOS-HH-211477
HouseholdTypeHousehold type
The recorded household structure.Example: Nuclear
FormationDateFormation date
The supplied household formation date.Example: 1953-12-27
HouseholdAgeYearsHousehold age years
Household age in years as supplied; no reference date was included.Example: 72
WardIdWard reference
The supplied ward identifier.Example: 9
WardNameWard name
The supplied ward name.Example: Trade-Fair
WardIncomeMultiplierWard income multiplier
Ward income multiplier as supplied in the extract.Example: 0.94
WardInformalSectorRateWard informal sector rate
Ward informal-sector rate as supplied in the extract.Example: 0.65
HeadCitizenIdHead resident reference
The resident identifier supplied for the current household head.Example: 596330
HeadNameHead name
The supplied name of the current household head.Example: Deola Alara
HeadAgeHead age
Head age as supplied; it is not an age at the join event.Example: 35
HeadGenderHead gender
The supplied gender value of the current household head.Example: M
HeadJoinDateHead join date
The join date supplied for the current head; no earlier membership events are inferred.Example: 1991-05-28
SpouseCitizenIdSpouse resident reference
The resident identifier supplied for the current spouse, when present.Example: 3469329
SpouseNameSpouse name
The supplied name of the current spouse.Example: Ebele Onwukwe
SpouseAgeSpouse age
Spouse age as supplied; it is not an age at the join event.Example: 49
SpouseGenderSpouse gender
The supplied gender value of the current spouse.Example: F
SpouseJoinDateSpouse join date
The join date supplied for the current spouse, when present.Example: 1977-03-22
HasCurrentSpouseCurrent spouse recorded
Whether the source records a current spouse.Example: 0
CurrentMemberCountCurrent member count
The supplied count of current members.Example: 4
HeadCountHead count
Current members with the Head role.Example: 1
SpouseCountSpouse count
Current members with the Spouse role.Example: 0
ChildCountChild count
Current members with the Child role.Example: 3
OtherMemberCountOther member count
Current members in other household roles.Example: 0
MaleCountMale count
Current members recorded as male.Example: 2
FemaleCountFemale count
Current members recorded as female.Example: 2
Age0To4CountMembers aged 0–4
Current members aged 0 to 4.Example: 0
Age5To14CountMembers aged 5–14
Current members aged 5 to 14.Example: 1
Age15To24CountMembers aged 15–24
Current members aged 15 to 24.Example: 1
Age25To64CountMembers aged 25–64
Current members aged 25 to 64.Example: 2
Age65PlusCountMembers aged 65+
Current members aged 65 or older.Example: 0
DependencyAgeCountDependency age count
The source count of dependency-age members.Example: 1
WorkingAgeCountWorking age count
The source count of working-age members.Example: 3
DependencyRatioPctDependency ratio (%)
Dependency-age members per 100 working-age members, as supplied.Example: 33.33
YoungestMemberAgeYoungest member age
Age of the youngest current member, as supplied.Example: 8
OldestMemberAgeOldest member age
Age of the oldest current member, as supplied.Example: 35
AverageMemberAgeAverage member age
Mean age of current members, as supplied.Example: 21.75
LifetimeMembershipRowsLifetime membership rows
The supplied lifetime count of membership rows; these individual rows are not included.Example: 5
HistoricalDeparturesHistorical departures
The supplied total of historical departures; individual departure dates are not included.Example: 1
FirstRecordedMembershipDateFirst recorded membership date
Earliest recorded membership date, as an aggregate endpoint. It is not a separate identified member event.Example: 1991-05-28
MostRecentMembershipActivityDateMost recent membership activity date
Latest membership activity date, as an aggregate endpoint. The specific activity is not identified.Example: 2019-12-29
IsLifecycleFormedHouseholdFormed through lifecycle
Whether the source flags this household as formed through lifecycle processing.Example: 0
HasMembershipHistoryMembership history recorded
Whether the source flags membership history.Example: 1
Download complete field guide JSON ↓
Additional records and schema context 1 documented sections
From a household code to a real membership history.

From a household code to a real membership history.

Inspect the published definitions and release context.

Read the published detail

See Follow the Citizen above for the full traced timeline.

Direct synthetic records from the current City Twin™ release. No record represents a real family.

Explore Household Data →

Public entity familyRepresentsDisclosure boundary
Household identitySynthetic household formation and closure contextPhysical household fields are controlled
Membership journeyRelationship roles and residence spans through timeExact reassignment sequence and fields are controlled
Housing connectionTenure and housing contextPhysical join path is controlled
Lifecycle contextBirth, death, marriage and migration effects on household stateTransition mechanics are controlled
Household IDHouseholdCodeFormationDateStatus

Connections

Known and possible relationships

Inspect the published definitions and release context.

Domain or contextRelationship and published scope
DemographicsCitizen / Death (age-eligibility and mortality-triggered widowhood) CitizenOrigin (Pregnancy childbirths tagged NaturalizationPath = 'Pregnancy')
Wardhousehold placement, ward-aware since the v3.4/v1.1 generation model fix
Housingtenancy, rent-payment and eviction context connected through the household identity spine
HealthPatient (field exists; Patient has 0 rows, Lagos)
Social ProtectionWIDOW beneficiary type exists, but is not created or triggered by Widowhood's real death-cascade mechanism above
Full relationship reference 1 documented sections
Known and possible relationships.

Known and possible relationships.

Inspect the published definitions and release context.

Read the published detail

Connections follow the published domain scope. Optional, contextual and planned relationships retain their stated limits below.

Domain or contextRelationship and published scope
DemographicsCitizen / Death (age-eligibility and mortality-triggered widowhood) CitizenOrigin (Pregnancy childbirths tagged NaturalizationPath = 'Pregnancy')
Wardhousehold placement, ward-aware since the v3.4/v1.1 generation model fix
Housingtenancy, rent-payment and eviction context connected through the household identity spine
HealthPatient (field exists; Patient has 0 rows, Lagos)
Social ProtectionWIDOW beneficiary type exists, but is not created or triggered by Widowhood's real death-cascade mechanism above

Domain guide

Households · archived guide edition

Striped Donkey V5.89 - 7 September 2026

Counts, prices and “live/today” certification statements reflect this dated edition. They are not a current rerun or offer. The current scope, known limits and accepted quote take priority.

Published scope and limits

Household size remains below the cited reference. Lifecycle fixes and remarriage are documented; exact assignment methods remain internal. The guide reports an ungenerated Patient household relationship. Households are synthetic, not civil records.

Read the source limits →
Accessible HTML reference 4 documented sections
Modelled entities.

Modelled entities.

Explore the entities and states represented by this domain.

Read the published detail

FCTE Households represent household composition, headship and membership as it exists for real synthetic citizens today — and as it existed for them before today, one row per membership span, not one row per citizen.

A longitudinal household identity with formation and closure context — every household is either active or historically closed.

Membership spans capture relationship role and residence period so a citizen can be followed through changing household composition.

Exactly one current Head per active household (certification check/C18), reassigned automatically when a household's circumstances change.

TwoParent, SingleMother, SingleFather, ChildHeaded, Extended, SinglePerson and Other — a measured classification, not a generated label (certification check).

Formation, departure, marriage, childbirth, widowhood, divorce and remarriage — represented as distinct longitudinal lifecycle mechanisms and independently auditable.

The same Household ID is read by Housing (Tenancy, RentPayment, Eviction) and registered for Health (Patient) — one identity, several real roles.

Household identity and membership belong to the shared Demographics lifecycle. This page documents household change separately because it is central to the longitudinal resident story, while internal architecture remains controlled.

Households don't stay the way they were generated.

Households don't stay the way they were generated.

Inspect the published definitions and release context.

Read the published detail

Pick a citizen to trace their actual residence history, one HouseholdMember row at a time.

Four household rows, four different roles, under six years — a marriage, a divorce, and a remarriage eleven days after the divorce closed her single-person household.

Living as a Child in a bulk-generated household before marrying out.

Marriage-formed household — closed after 5½ years by divorce.

Divorce-formed single-person household — lasted 11 days before remarriage.

Remarriage-formed household — her current, live residence today.

Married into household HHLM001887863 in 2020, had a son in 2021, and departed alone after a 2026 divorce — custody of their son stayed with the father, who kept the household.

Born into this household; left at 18 to marry.

Marriage-formed household with Citizen 1887863 (Head). Son Citizen 5022698 born here 2021-02-16 (naturalization-path context = 'Pregnancy') — a real childbirth into an existing household, not a new household code.

Divorce-formed single-person household. Her ex-husband (1887863) kept HHLM001887863 and full-time custody of their son — an independent per-child custody roll, not automatic.

No marriage, no divorce — just an adult child leaving the household he was born into, as represented by the household departure mechanism.

Born into this household; departed independently at age 19 — no marriage, no death, just an adult child moving out.

Departure-formed single-person household — his current, live residence today.

Trace a Citizen Yourself →

Lifecycle transitions are represented as longitudinal events, not static flags.

Lifecycle transitions are represented as longitudinal events, not static flags.

Inspect the published definitions and release context.

Read the published detail

Six of these run as an incremental pass over the existing population; the seventh (Formation) only runs once, at city origin. Dissolution is not an eighth mechanism — it is the shared consequence, the Dissolve Household If Empty step, triggered automatically by Widowhood or Remarriage when a household's last current member leaves.

Households are initialized with city- and area-aware demographic context. Exact starting volumes, assignment sequence and generation methods are controlled.

A Child-role citizen 18+ leaves to head a brand-new single-person household.

Two Child-role citizens marry via age-banded propensity, rank-aligned by DOB within their ward.

Household roles are updated consistently after a death so longitudinal household state remains coherent. Exact reassignment sequence and transition logic are controlled.

Departing spouse forms a new single household; each child independently rolls custody — siblings can split between parents.

Closes and dissolves both partners' prior single households before forming one new joint household.

A known v1 boundary, disclosed: Remarriage currently excludes widowed parents who kept custody of a still-populated household.

A population, then a lifecycle laid on top of it.

A population, then a lifecycle laid on top of it.

Review the documented generation rules and assumptions.

Read the published detail

Household formation begins from city- and area-aware demographic context, then lifecycle changes are applied through controlled incremental passes. Release integrity checks protect chronology and relationship consistency. Exact staging, transaction, pairing and row-level repair logic are intentionally not published.

Mean household size (3.63, Lagos), family structure mix and every lifecycle-event count on this page, verified live via analysis-ready.

Widowhood's child-headed household outcome (26.4% of all Lagos households) — a direct, measured consequence of the Death + cascade mechanism, not separately generated.

Household size, composition, relationship structure and lifecycle-event distributions are calibrated to published demographic evidence and city-level certification targets. Exact matching weights and transition rules remain controlled.

Individual synthetic assignments are generated under controlled domain rules. Exact sampling, assignment order and parameterization are not published.

View Household Generation Methodology →

Fertility grounding for the Pregnancy mechanism, per city.

certification check — a measurement, not a target; no cited external benchmark yet.

Structural (certification check–C21) and realism (certification check–R08) batteries run live in Lagos.

Open Household Source Catalogue →

Evidence & limits

Scope and known limits

Household size remains below the cited reference. Lifecycle fixes and remarriage are documented; exact assignment methods remain internal. The guide reports an ungenerated Patient household relationship. Households are synthetic, not civil records.

Evidence, findings and release history 3 documented sections
Known limits.

Known limits.

Household size remains below the cited reference. Lifecycle fixes and remarriage are documented; exact assignment methods remain internal. The guide reports an ungenerated Patient household relationship. Households are synthetic, not civil records.

Read the published detail

Lagos's live mean household size (3.63) passes certification check's certified 1.5–7.0 band but sits below the specific Nigeria NDHS reference of ~4.8–5.0 cited alongside that band. Disclosed here, not glossed over.

Several integration defects affecting lifecycle consistency were identified and repaired during release hardening. Public history records the affected behavior and resolution; exact staging, transaction, ordering and row-repair mechanics remain internal.

The lifecycle model was expanded so remarriage can be represented without forcing an artificial household recreation. The behavioral fix is public; exact pairing and household-assignment logic is not.

Earlier city releases differed in a few household-history capabilities. The public model is now normalized at the semantic level; physical migration steps and field-level changes are intentionally withheld.

patient-to-household relationship exists in the data structure but Patient itself has 0 rows on Lagos today — registered, not yet generated.

No synthetic household corresponds to a real family. Every citizen, relationship and lifecycle transition on this page is statistically generated, not drawn from real civil records.

View All Household Limitations →

Does the synthetic lifecycle resemble a real household?

Does the synthetic lifecycle resemble a real household?

Inspect the published definitions and release context.

Read the published detail

Both structural and realism certification pass with 0 FAIL in Lagos today — a stronger position than most domains at this stage, achieved after several real bugs were found live and fixed. Two disclosed gaps remain, not hidden.

Open Household Realism Report →

The full certification check–C21 structural battery plus the 8-check certification check–R08 realism battery run live against Lagos release. Lagos legitimately marks 2 checks N/A (two optional household structural capabilities are not present in this city release) rather than forcing a false PASS — disclosed, not hidden.

A separate 8-check realism suite (certification check–R08) passes 8/8 on this City Twin™ today, with 0 FAIL and 0 WARN.

Explore Every Household Check →

  • certification check — one current membership per citizen: 0 violations, Lagos
  • certification check — at most one current Spouse per household: 0 violations, Lagos
  • certification check — JoinDate never precedes member's own DOB: 0 violations, Lagos
  • certification check — every Head has a matching HouseholdMember row: 0 violations
  • certification check — dissolved households carry zero current members: 0 violations
  • certification check (Lagos) — DissolutionDate/IsActive mismatch: N/A, no IsActive field on Lagos
  • certification check — chronological ordering across multi-hop chains: 0 violations, Lagos
  • certification check — 80+ mortality-cohort consistency check: PASS, Lagos (floor 15%)
  • certification check — mean household size within 1.5–7.0: PASS, Lagos
  • certification check / R03 — birth/death rates within UN WPP 2022 bands: PASS, Lagos
  • certification check — family structure measurement (7 categories): informational, no FAIL condition
The lifecycle got more honest with every real bug found.

The lifecycle got more honest with every real bug found.

Inspect the published definitions and release context.

Read the published detail

View Full Demographics Change Log →

Access & datasets

Scope your data request

Choose the records, dates and connected domains you need. Final availability, delivery scope and licensing are agreed with your quote.

Published access and recorded examples 1 documented sections
Recorded example.

Recorded example.

Explore the supplied synthetic example and its source references.

Read the published detail

Formed by one of the seven Household Lifecycle mechanisms — Housing waits for it, doesn't create it.

A housing occupancy relationship opens in the same area, carrying tenure and rent context through time.

The household's own composition changes; Housing reacts only when the household itself dissolves.

Multiple Tenancy rows per unit stay queryable, ordering enforced by repair workflows and H14.

Available as Standalone Domain · Multi-Domain Bundle · Full City Twin™