glx households

Reconstruct census households

Synopsis

Reconstruct census households from the archive. Every census event is one household: the people enumerated in it, with their role, relationship to the head, and age at the census (participant property age_at_event).

Members are listed head first, then by age, oldest first. The head is the participant whose relationship_to_head is "head", otherwise the first named participant in a principal/subject role. Members a head-only schedule counts without naming (participant property named: false) are marked "counted, not named", and the event's household tally (the tick-mark columns of 1790-1840 style schedules) is printed under the members.

With a person, lists each census household that person appears in. With --place, lists every census household at that place or any place inside it; combine with --year to look at a single enumeration. --neighbors adds the households recorded as page neighbors on each census event.

The person argument can be an exact entity ID or a name to search for.

glx households [person] [flags]

Examples

  # Every census household a person appears in
  glx households person-robert-webb

  # One census year only
  glx households person-robert-webb --year 1860

  # Every household enumerated at a place in 1860
  glx households --place place-millbrook-hartford --year 1860

  # Include page neighbors, for FAN research
  glx households person-abram-baker --neighbors

  # Machine-readable output
  glx households person-robert-webb --format json

Options

  -a, --archive string   Archive path (directory or single file) (default ".")
      --format string    Output format: text or json (default "text")
  -h, --help             help for households
      --neighbors        Show the page neighbors recorded on each census event
      --place string     Only households at this place ID (includes descendant places)
      --year int         Only households from this census year

Options inherited from parent commands

  -q, --quiet   Suppress non-error output (where supported)

SEE ALSO

• glx - GENEALOGIX CLI - Manage and validate genealogy archives