glx analyze

Analyze archive for research gaps, evidence quality, and consistency

Synopsis

Run automated analysis on a GENEALOGIX archive to surface research gaps, unsupported claims, chronological inconsistencies, and suggested next steps.

Analysis categories: gaps Missing data that should be findable (no birth, no parents, etc.) evidence Unsupported or weakly supported claims (no citations, single source) consistency Chronological cross-checks (death before birth, implausible lifespan) conflicts Definite conflicts, possible overlaps, and known disputes suggestions Research recommendations (census years to search, vital records)

Use --check to run a single category. By default, all categories are analyzed.

Conflicts include assertions on the person, their events and relationships, and competing dates/places on duplicate birth or death events. Definite conflicts are HIGH, possible overlaps MEDIUM, and known disputes LOW. Disproven claims and undated temporal values are excluded. Touching periods are history.

Use --approximation-years to change the default ±2-year tolerance for approximate date values. Use --format json for machine-readable output.

glx analyze [person] [flags]

Examples

  # Full analysis of current directory
  glx analyze

  # Focus on one person
  glx analyze person-jane-webb

  # Run only gap analysis
  glx analyze --check gaps

  # JSON output for tooling
  glx analyze --format json

  # Analyze a specific archive
  glx analyze --archive my-archive

  # Assume UK censuses where the archive names no country
  glx analyze --country "United Kingdom"

Options

      --approximation-years int   Tolerance in years for ABT, EST and CAL date values (0–10000) (default 2)
  -a, --archive string            Archive path (directory or single file) (default ".")
  -c, --check string              Run a single analysis category (gaps, evidence, consistency, conflicts, suggestions)
      --country string            Country whose census schedule to assume for persons whose places name no country (default "none", which suggests no census records)
  -f, --format string             Output format (json for machine-readable)
  -h, --help                      help for analyze
  -p, --person string             Filter results to a specific person (ID or name)

Options inherited from parent commands

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

SEE ALSO

• glx - GENEALOGIX CLI - Manage and validate genealogy archives