This function computes Tajima's D for a sliding window across each chromosome.
Arguments
- .x
a (potentially grouped)
gen_tibbleobject- ...
other arguments passed to specific methods, currently unused.
- type
type of object to return, if using grouped method. One of "matrix", "tidy", or "list". Default is "matrix". Data can be grouped by more than one variable: groups are then labelled by the values of the grouping variables pasted with "." (e.g.
pop1.F), and the "tidy" output has one column per grouping variable rather than a singlegroupcolumn. Thegroupcolumn, or the columns of the grouping variables, keep the type of the grouping variables (e.g. a factor keeps its levels), so that groups stay in their order when the output is sorted or plotted.- window_size
The size of the window to use for the estimates.
- step_size
The step size to use for the windows.
- size_unit
Either "snp" or "bp". If "snp", the window size and step size are in number of SNPs. If "bp", the window size and step size are in base pairs.
- min_loci
The minimum number of loci required to calculate a window statistic. If the number of loci in a window is less than this, the window statistic will be NA.
- complete
Should the function be evaluated on complete windows only? If FALSE, the default, then partial computations will be allowed at the end of the chromosome.
Value
if data is not grouped, a data frame with the following columns:
chromosome: the chromosome for the windowstart: the starting locus of the windowend: the ending locus of the windowtajimas_d: the Tajima's D for the population if data are grouped, either: a data frame as above with the following columns:chromosome: the chromosome for the windowstart: the starting locus of the windowend: the ending locus of the windown_loci: the number of loci in the window (including loci with no genotyped individuals in some groups; the number of loci with data in each group is given by the "tidy" and "list" outputs)group: the Tajima's D for the group for the given window (there will be as many of these columns as groups in the gen_tibble, and they will be named by the grouping levels) a tidy tibble with the following columns:chromosome: the chromosome for the windowstart: the starting locus of the windowend: the ending locus of the windown_loci: the number of loci in the windowgroup: the name of the groupstat: the Tajima's D for the given group at the given window or a list of data frames, one per group, with the following columns:chromosome: the chromosome for the windowstart: the starting locus of the windowend: the ending locus of the windowstat: the Tajima's D for the given windown_loci: the number of loci in the window
Details
Missing genotypes are accounted for by using the number of
non-missing allele copies at each locus as its sample size, following
Bailey et al. (2025) as implemented in pixy. See pop_tajimas_d() for
details. Loci with no genotyped individuals are ignored, and are not
counted in n_loci. With windows defined in base pairs and
step_size equal to window_size, the windows match those used by
pixy.
References
Bailey N, Stevison L, Samuk K (2025) Correcting for bias in estimates of \(\theta_W\) and Tajima's D from missing data in next-generation sequencing. Molecular Ecology Resources, e14104. doi:10.1111/1755-0998.14104
Examples
example_gt <- load_example_gt("grouped_gen_tbl")
# Calculate Tajima's D across a window of 3 SNPs, with a step size of 2 SNPs
example_gt %>%
windows_pop_tajimas_d(
window_size = 3, step_size = 2,
size_unit = "snp", min_loci = 2
)
#> # A tibble: 3 × 7
#> chromosome start end n_loci pop1 pop2 pop3
#> <chr> <dbl> <dbl> <dbl> <dbl> <dbl> <dbl>
#> 1 chr1 1 3 3 1.03 -Inf -0.710
#> 2 chr1 3 5 2 1.24 -0.612 -0.612
#> 3 chr2 1 3 2 0.311 -0.710 NaN
