Glossary
AC (Allele Count)
Number of copies of the alternate allele observed across eligible samples. A heterozygous carrier contributes 1; a homozygous alt carrier contributes 2; a carrier with a single copy of the locus (hemizygous, or on chrM) contributes 1. See Key Concepts.
AF (Allele Frequency)
Ratio of AC to AN (AC / AN). Represents the proportion of alleles that are the alternate allele among eligible samples. Returns None when AN=0. See Key Concepts.
AN (Allele Number)
Total number of alleles examined across eligible samples, leaving out samples with a failed call at the position (N_FAIL). For autosomes, AN = 2 Γ (eligible samples β N_FAIL), or 2 Γ eligible samples with --fail-as-ref. For sex chromosomes, AN depends on ploidy. See Ploidy & Sex Chromosomes.
Bitmap
See Roaring Bitmap.
Bucket
A 1 Mbp (1,000,000 base pair) genomic interval used to partition variant data within each chromosome. Bucket 0 covers positions 0β999,999; bucket 1 covers 1,000,000β1,999,999; and so on. See Data Model.
Carrier
A sample that has at least one copy of the alternate allele at a given position (heterozygous, homozygous alt, or hemizygous). Use variant-info to list carriers with their metadata. See Variant Info.
Capture Index
An interval tree (stored as a .pkl file) built from a BED file that defines the genomic regions covered by a whole-exome sequencing (WES) technology. Used to determine which WES samples are eligible at a given position. WGS samples do not require a capture index. See Key Concepts.
Eligible Sample
A sample that passes all query filters (sex, phenotype, technology), has coverage at the queried position and carries at least one copy of that locus β females are not eligible on chrY, and nobody is in the chrY PARs. Only eligible samples contribute to AC and AN, and only if their call there did not fail. See Sample Filtering.
Hemizygous
Having a single copy of a locus that is normally present in two. In AFQuery this is a male on chrX outside the PARs or on chrY: a male carrying the alternate allele there is counted in N_HEMI and contributes 1 to AC and AN. chrM is haploid but not hemizygous β it is a multi-copy genome β so its carriers are counted in N_HOM_ALT. See Ploidy & Sex Chromosomes.
N_FAIL
The count of eligible samples with a failed call for any allele at a position: a call with FILTERβ PASS, or a genotype inconsistent with the sample's ploidy (such as 0/1 on chrX non-PAR in a male). Their genotype there is unknown, so they are left out of AC and AN for every allele at the position. See FILTER=PASS Tracking.
N_HEMI
The count of eligible hemizygous carriers: males carrying the alternate allele on chrX outside the PARs or on chrY, whether the VCF wrote the genotype haploid (1) or diploid (1/1). A male's heterozygous call (0/1) there is a failed call (N_FAIL) instead. Always 0 on autosomes, the chrX PARs, chrM and for females. See Understanding Output.
N_NO_COVERAGE
The count of eligible samples whose tech lacks coverage evidence at this position. Excluded from N_HOM_REF; they still count in AN. Always 0 unless a coverage-evidence filter (--min-pass, --min-observed, --min-quality-evidence, or build-time --min-covered) is active. See Coverage Evidence.
Manifest
A TSV file that maps each sample to its VCF path, sex, sequencing technology, and phenotype codes. The manifest drives database creation and is parsed into metadata.sqlite. See Manifest Format.
Metadata Code
Legacy term. See Phenotype Code.
Parquet
A columnar storage format used by AFQuery to store variant bitmaps on disk. Each Parquet file covers one bucket within one chromosome and contains rows sorted by (pos, alt). See Data Model.
PAR (Pseudoautosomal Region)
The two regions (PAR1, PAR2) at the ends of chrX and chrY that share the same sequence and recombine like an autosome, so every sample is diploid there. AFQuery counts them once, at their chrX coordinates; positions in the chrY PARs are not genotyped. See Ploidy & Sex Chromosomes.
Phenotype Code
An arbitrary string label assigned to a sample in the manifest (e.g., ICD-10 codes, HPO terms, project tags). Multiple codes per sample are supported. Phenotype codes enable cohort stratification at query time. See Key Concepts.
Ploidy
The number of allele copies at a given locus, which depends on chromosome type and sex. Autosomes and the chrX PARs are diploid (ploidy=2) for all samples. chrX non-PAR is haploid for males, diploid for females; chrY non-PAR is haploid for males and absent in females; chrM is haploid for everyone. The chrY PARs are not genotyped (ploidy 0), because PAR loci are counted on chrX. See Ploidy & Sex Chromosomes.
Roaring Bitmap
A compressed bitset data structure that efficiently stores sets of integers. AFQuery uses Roaring Bitmaps (via the pyroaring library) to represent which samples carry a given genotype. Typical compression: ~2 bytes per sample per variant. See roaringbitmap.org.
Schema Version
The AFQuery database format version stored in manifest.json β 2.0, or 3.0 when the database was built with coverage-quality filters. See Data Model.
Technology
The sequencing platform or assay type assigned to a sample (e.g., wgs, wes_v1, panel_cardiac). Determines capture index eligibility and enables technology-stratified queries. See Technology Integration.