Pedigree Validation and Ancestry Assessment App

Familia is a Shiny web application developed by Breeding Insight to support pedigree validation and ancestry assessment of plant and animal populations. The app integrates Mendelian error analysis, parentage assignment, supervised ancestry estimation, and unsupervised ancestry inference to help breeding programs evaluate genomic relationships through an accessible, providing a web-based interface to BIGpopA

Overview

Accurate pedigree records and ancestry information are foundational to modern breeding programs. Familia provides an interactive and reproducible framework for:

• Detecting and correcting structural pedigree errors before downstream analysis
• Validating pedigree trios using Mendelian error analysis
• Assigning parentage to progeny from candidate parent pools
• Estimating line and breed composition through supervised ancestry methods
• Inferring population structure through unsupervised ancestry estimation

The application is designed to be species-agnostic and adaptable to a wide range of plant and animal breeding programs.

Key Features

Pedigree Cleaning

• Detection of exact duplicate records, conflicting trios, and inconsistent sex roles
• Automatic addition of missing parents with unknown parent codes
• Detection of cycles and circular dependencies in pedigree relationships
• Configurable correction options with interactive review of flagged records
• Exportable corrected pedigree and per-issue result tables

Pedigree Validation

• Mendelian error analysis across trios using marker genotype data
• Configurable error thresholds for trio and single-parent evaluations
• Automatic classification of trios into Pass, Fail, Low Markers, No Genotype Data, Founders, and Missing Parents categories
• Optional founders file to preserve known founder trios
• Exportable corrected pedigree and per-status result tables

Parentage Assignment

• Support for best pair, best male parent, best female parent, and best match assignment methods
• Configurable error threshold and minimum marker filters
• Tie detection and self-match exclusion options
• Results classified as Pass, High Error, or Low Markers
• Exportable full results and per-status tables

Line/Breed Composition Estimation (PolyBreedTools)

• Supervised ancestry estimation based on reference population genotypes
• Support for polyploid species via configurable ploidy parameter
• Interactive ancestry bar plot with customizable color palettes
• Automatic filtering of low-quality samples and markers
• Exportable results as Excel files

Unsupervised Ancestry Estimation (SNMF)

• Unsupervised ancestry inference via LEA::snmf()
• Supports VCF, VCF.gz, and LEA .geno input formats
• Configurable K range, repetitions, alpha, iterations, and tolerance
• Cross-entropy-based automatic or manual K selection
• Interactive Q-matrix ancestry plot with sort and label controls
• Exportable Q-matrix CSV and cross-entropy summary

Installation and Running the App

Familia uses a golem application structure, allowing it to be installed like a standard R package.

Install from GitHub

if (!requireNamespace("remotes", quietly = TRUE)) {
  install.packages("remotes")
}
remotes::install_github("Breeding-Insight/Familia")

Run Familia

Familia::run_app()

Dependencies

Key R packages used by Familia include:

• shiny
• BIGpopA
• bs4Dash
• DT
• vcfR
• data.table
• rlang
• openxlsx
• zip

• LEA (required for SNMF-based ancestry inference)

  Citation

If you use Familia in research, please cite it as: Chinchilla-Vargas, J., Sandercock, A. M., & Breeding Insight Team (2026). Familia: R Shiny Application for Population Structure and Ancestry Assessments. R package version 1.0.2. https://github.com/Breeding-Insight/Familia/

Also cite:

• For sNMF:
  • Frichot et.al for original methods
  • Frichot et.al for LEA package
• BreedTools^poly:
  • Funkhouser et al. for original BreedTools methods
    
  • Sandercock et al. for methods expansion to polyploidy

License

Familia is released under the Apache License, Version 2.0. See the LICENSE file or https://www.apache.org/licenses/LICENSE-2.0 for details.

Acknowledgments

Familia is developed as part of the Breeding Insight initiative (https://www.breedinginsight.org) to provide open-source, data-driven tools for modern breeding programs.