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
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.
- 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
- 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
- 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
- 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 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
Familia uses a golem application structure, allowing it to be installed like a standard R package.
if (!requireNamespace("remotes", quietly = TRUE)) {
install.packages("remotes")
}
remotes::install_github("Breeding-Insight/Familia")Familia::run_app()Key R packages used by Familia include:
- shiny
- BIGpopA
- bs4Dash
- DT
- vcfR
- data.table
- rlang
- openxlsx
- zip
- LEA (required for SNMF-based ancestry inference)
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/
- For sNMF:
- Frichot et.al for original methods
- Frichot et.al for LEA package
- BreedToolspoly:
- Funkhouser et al. for original breedTools methods
- Sandercock et al. for methods expansion to polyploidy
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.
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.