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 region is reported as a movement (e.g. "Florida → Wisconsin"). Regions compare at the state/region level of the place hierarchy, and pre-statehood territories match their successor states ("Florida Territory" equals "Florida").

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 region sequence. 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