glx migrations

Track a person's geographic movement over time

Synopsis

Trace a person's geographic movement over time by collecting every dated place observation: events they participated in (birth, census, marriage, ...), their children's birth events (a child's birthplace is evidence of the parent's residence), and residence property values.

Observations are sorted chronologically and each change of place is reported as a movement, named at the highest level of the place hierarchy where the two places differ: "Florida → Wisconsin" between two states, "Niederkleen → Pohl-Göns" between two villages of one district. A place and a place inside it (a state and one of its towns) are not a move. Country and continent levels are skipped, and pre-statehood territories match their successor states ("Florida Territory" equals "Florida").

Not every observation counts toward a movement. An event in which the person's role does not put them at its place (a grantor or grantee of a deed, a legatee or heir of an estate, someone merely mentioned) is shown but not counted, and so is a parent named on a child's death or burial, which places the child rather than the parent's household; an archive can mark its own roles with implies_presence in the participant roles vocabulary. A bounded residence value overrides an event elsewhere only when the event's whole possible date span fits within that residence: the event remains visible but is not counted as a move. Open-ended event spans remain included. Dates in different calendars are not compared without conversion.

With --pattern, searches all persons in the archive for a migration pattern instead: a comma-separated list of places that must appear in chronological order in a person's sequence of places. Knowing who else made the same move narrows the search for a person's family.

The person argument can be an exact entity ID (e.g., person-jane-webb) or a name to search for (e.g., "Jane Miller"). If the name matches multiple persons, all matches are listed for disambiguation.

Use --family to also show the timelines of the person's immediate family (spouses, parents, children). Use --format json for machine-readable output.

Not to be confused with "glx migrate", which upgrades archive data to newer spec conventions.

glx migrations [person] [flags]

Examples

  # Migration timeline by person ID
  glx migrations person-jane-webb

  # Find everyone who moved from Florida to Wisconsin
  glx migrations --pattern "Florida,Wisconsin"

  # Include immediate family timelines
  glx migrations "Jane Miller" --family

  # Machine-readable output
  glx migrations person-jane-webb --format json

Options

  -a, --archive string   Archive path (directory or single file) (default ".")
      --family           Also show timelines for the person's immediate family
      --format string    Output format: text or json (default "text")
  -h, --help             help for migrations
      --pattern string   Find persons matching a migration pattern (comma-separated places, in order)

Options inherited from parent commands

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

SEE ALSO

• glx - GENEALOGIX CLI - Manage and validate genealogy archives