 Methodology article
 Open Access
 Published:
mixIndependR: a R package for statistical independence testing of loci in database of multilocus genotypes
BMC Bioinformatics volume 22, Article number: 12 (2021)
Abstract
Background
Multilocus genotype data are widely used in population genetics and disease studies. In evaluating the utility of multilocus data, the independence of markers is commonly considered in many genomic assessments. Generally, pairwise nonrandom associations are tested by linkage disequilibrium; however, the dependence of one panel might be triplet, quartet, or other. Therefore, a compatible and userfriendly software is necessary for testing and assessing the global linkage disequilibrium among mixed genetic data.
Results
This study describes a software package for testing the mutual independence of mixed genetic datasets. Mutual independence is defined as no nonrandom associations among all subsets of the tested panel. The new R package “mixIndependR” calculates basic genetic parameters like allele frequency, genotype frequency, heterozygosity, Hardy–Weinberg equilibrium, and linkage disequilibrium (LD) by mutual independence from population data, regardless of the type of markers, such as simple nucleotide polymorphisms, short tandem repeats, insertions and deletions, and any other genetic markers. A novel method of assessing the dependence of mixed genetic panels is developed in this study and functionally analyzed in the software package. By comparing the observed distribution of two common summary statistics (the number of heterozygous loci [K] and the number of share alleles [X]) with their expected distributions under the assumption of mutual independence, the overall independence is tested.
Conclusion
The package “mixIndependR” is compatible to all categories of genetic markers and detects the overall nonrandom associations. Compared to pairwise disequilibrium, the approach described herein tends to have higher power, especially when number of markers is large. With this package, more multifunctional or stronger genetic panels can be developed, like mixed panels with different kinds of markers. In population genetics, the package “mixIndependR” makes it possible to discover more about admixture of populations, natural selection, genetic drift, and population demographics, as a more powerful method of detecting LD. Moreover, this new approach can optimize variants selection in disease studies and contribute to panel combination for treatments in multimorbidity. Application of this approach in real data is expected in the future, and this might bring a leap in the field of genetic technology.
Availability
The R package mixIndependR, is available on the Comprehensive R Archive Network (CRAN) at: https://cran.rproject.org/web/packages/mixIndependR/index.html.
Background
Genetic polymorphisms are commonly classified into different types, such as SNPs, InDels, and STRs. Different characteristics, such as mutation rates, deviations, and heterozygosity, make those markers isolated in application. However, due to their specific advantages, such as the higher power of discrimination of STRs, and the important roles of SNPs in application of ancestry informative markers (AIMs) and prediction of physical traits [1], mixed multiplex assays are considered more multifunctional [2,3,4] in some applications of molecular genetics. While there are many studies that compare one marker to others of their kind (SNPs to SNPs, STRs to STRS), only rarely are comparisons made between marker classes. A few notable exceptions include a 2002 study that noted the linkage disequilibrium (LD) of SNPs and microsatellites [5]. Later in 2017, 13 CODIS STR markers were found to be matched to genomewide SNP profiles with median accuracies in excess of 90% [4]. Even though the disequilibrium among different markers can be significant and the hypothesis of independence may require testing, most of the software available now is designed specifically for one kind of those markers. For example, adegenet, which analyzes SNPs and STRs separately; BCFTools [6] and SNPrelate [7], both of which focus on SNPs; and Genetic Data Analysis (GDA) [8], which targets at STRs specially. Therefore, a software compatible with multitype genetic markers simultaneously that can test independence between different type of data is needed.
Another shortcoming of traditional measures of LD is the way it is assessed, that is to test pairwise linkage disequilibrium. However, due to more accurate conception, nonrandom associations can be not only pairwise associations, but also triplet, quartet, and higher order associations among all sites, defined as mutual independence. D′ is sometimes used to assess the higherlevel associations, but it is time consuming to obtain due to numerous calculations. Therefore, summary statistics become a choice to avoid all these excess and burden.
A new package, mixIndependR, was developed for testing mutual independence among all sites of the multilocus genotypes mixed type of genetic markers for the R software. As a larger category of dependency across all over the panel needs to be tested, summary statistics, which are able to give a quick and comprehensive description of the dataset, came into consideration. In an early study [9, 10], summary statistics, such as the number of heterozygous loci (K) and the number of shared alleles (X), were used to test the significance of disequilibrium (nonrandom associations) or dependency between loci by comparing the observed and expected distributions under the hypothesis of mutual independence. Functions for obtaining basic genetic parameters like allele frequency, genotype frequency, heterozygosity, and Hardy–Weinberg equilibrium (HWE) are also included in mixIndependR to increase its versatility.
Results
Software pipeline
This section presents how a multilocus genotype panel with mixed genetic markers (SNPs and STR) can be tested for its mutual independence using mixIndependR. In the following example, a sample with 6 STRs and 94 SNPs (Additional file 8: Table S1) was tested using mixIndependR. This panel was designed after variant selection and pruning with the threshold \(r^{2} < 0.1\) by plink (version 1.90), based on the genotypes and the reference panel created by Saini et al. [11]. This reference haplotype panel was created by imputing STR genotypes into existing SNPs datasets. The STRs were selected from genomewide catalog of STR variation they generated in Simons Simplex Collection (SSC) cohort, and genotype data for 2504 individuals are from existing 1000 genome phase 3 [11]. The threshold for independent panels is usually set as 0.2 [12, 13], but here we narrowed the scope in pruning to get a panel with less possibility to carry dependency. In addition, pairwise correlations of this dataset were exported and check, and no dependent pairs have been found with the usual threshold of 0.2. This dataset is included in the mixIndependR package under the name “mixexample”. mixIndependR is compatible with genotype files in a tabular format (e.g., excel, cvs) and the variant call format (vcf) [14]. The allele separator in the genotypes needs to be specified using the “sep” parameter.

x < mixexample # This panel with 96 SNPs and 4 STRs are filtered from a reference haplotype panel developed by Saini et al. [11]
mixIndependR can be used to estimate basic genetic parameters, such as allele frequencies, tables of heterozygosity and of shared alleles, and to test Hardy Weinberg equilibrium in either Pearson’s.
Chisquared test.

p < AlleleFreq(x,sep = "\\") # calculate the table of allele frequencies and return a table with rows of alleles and columns of markers (Additional file 9: Table S2).

G < GenotypeFreq(x,sep = "\\",expect = FALSE) # calculate the observed genotype frequencies with genotypes in rows and markers in columns.

G0 < GenotypeFreq(x,sep = "\\",expect = TRUE) # calculate the expected genotype frequencies under Hardy–Weinberg equilibrium (HWE).

h < Heterozygous(x,sep = "\\") # obtain the table of heterozygosity with rows of individuals and columns of markers, where “1” denotes heterozygous while “0” denotes homozygous (Additional file 10: Table S3).

H < RxpHetero(h,p,HWE = TRUE) # calculate the observed average heterozygosity or the expected heterozygosity on each marker under the assumption of HWE.

AS < AlleleShare(x,sep = "\\",replacement = FALSE) # calculate the table of shared alleles of each pair of individuals for each marker with the rows denoting the pairs of individuals and the columns denoting the variants. If the replacement is TRUE, the pairs are formed with replacement randomly and this table includes all possible pairs; if the replacement is FALSE, the pairs are formed without replacement randomly and the number of pairs equals half of the sample size. (Additional file 11: Table S4).

e < RealProAlleleShare(AS) # calculate the observed proportions of sharing 0, 1 or 2 alleles on each marker.

e0 < ExpProAlleleShare(p) # calculate the expected probabilities of sharing 0, 1 or 2 alleles on each marker for any unrelated individuals. This process is according to the functions described by Weirs et al. [15]

HWE_pvalue < HWE.Chisq(G,G0,rescale.p = T, simulate.p.value = T,B = 2000) # test the HWE with Pearson’s Chisquare test and export the p value for each marker.
According to the mathematical principles described in previous studies of Chakraborty et al. [9, 10], the observed and expected distribution of the number of heterozygous loci (K) and number of share alleles (X) can be constructed and visualized (Additional file 1: Figure S1, Additional file 2: Figure S2).

ObsDist_K < FreqHetero(h) # calculate the observed distribution of K, exporting the frequencies of K at the values from 0 to total number of tested markers.

ExpDist_K < DistHetero(H) # calculate the expected distribution of K, exporting the probabilities of K at the values from 0 to total number of tested markers.

ObsDist_X < FreqAlleleShare(AS) # calculate the observed distribution of X, exporting the frequencies of X at the values from 0 to 2 times of total number of tested markers.

ExpDist_X < DistAlleleShare(e) # calculate the expected distribution of X, exporting the probabilities of X at the values from 0 to 2 times of total number of tested markers.

df_K < ComposPare_K(h,ExpDist_K,trans = F) #generate comparison data frame for observed and expected distributions. If “trans = F”, the table contains a variable “OvE” denoting the category of “observed” or “expected”, and a variable “Freq” denoting the frequencies. This format is prepared for visualization in “ggplot2”. If “trans = T”, the result is made by two columns “K_io” and “K_ie” which denoting the observed and expected K for each individual, and the number of rows equals to the number of individuals of the sample.

df_X < ComposPare_X(AS,ExpDist_X,trans = F) #generate comparison data frame for observed and expected distributions. If “trans = F”, the table contains a variable “OvE” denoting the category of “observed” or “expected”, and a variable “Freq” denoting the frequencies. This format is prepared for visualization in “ggplot2”. If “trans = T”, the result is made by two columns “X_io” and “X_ie” which denoting the observed and expected X for each pair of individuals, and the number of rows equals to the number of pair of individuals of table of number of shared alleles AS.
Not only were the visual comparisons made, but statistical tests were also conducted using this package. Considering the expected distributions under assumption of mutual independence follow restricted multinomial distributions with fixed probabilities on each trial, no traditional statistic tests can be applied (e.g. traditional chisquare test for multinomial distribution). Instead, simulations were conducted to obtain null distributions of chisquare values and cumulative probability functions were built to find an accurate critical value.

Simu_K < Simulate_DistK(H,2504,500) #build 500 times of simulations for distribution of K with the sample size equals to the original data for each simulation, under the mutual independence assumption (Additional file 12: Table S5).

Simu_X < Simulate_DistX(e,1252,500) #build 500 times of simulations for distribution of X with the sample size equals to the number of pairs composed in “AS” table for each simulation, under the mutual independence assumption (Additional file 13: Table S6).

x2_K < Dist_SimuChisq(Simu_K,ExpDist_K$Density,1000) # Calculate 500 Chisquare values for K with 1000 times of replicates in each and export the set of p values.

x2_X < Dist_SimuChisq(Simu_X,ExpDist_X$Density,1000) # Calculate 500 Chisquare values for X with 1000 times of replicates in each and export the set of p values.

P1 < ecdf(x2_K) #Build the cumulative probability of function for the set of Chisquare values. Note: this is the function in the package of “stats”.

P2 < ecdf(x2_X) #Build the cumulative probability of function for the set of Chisquare values. Note: this is the function in the package of “stats”.
If the significant level is 0.05, the critical value of the chisquare value for each specific expected distribution is the value when cumulative probability equals 95%. In Additional file 3: Figure S3 and Additional file 4: Figure S4, the cross points of vertical and horizontal line are the critical values. In this example, the critical value for K is 112.9 and the test chisquare value equals 77.417; while 115.0 as critical value for X and test statistic is 62.229. In both statistics, we fail to reject the null hypothesis and may conclude the panel is mutual independent. This results also agree with the selection rules in the process of variant pruning on plink that the pairwise squared correlation between genotype allele counts “indeppairwise” is smaller than 0.1 [16, 17]. However, the result in this section represents a single analysis, and the results can vary among different trials.
Statistical analysis
Both simulation and real data have been tested with this approach. We simulated unlinked and linked data under the WrightFisher neutral model using the software ms [18]; the microsatellite data were converted by microsat [19] from ms format. In the singlecomparison example, we used the simulated panel with 20 STRs and 10 SNPs for unlinked and fullylinked scenarios and the sample size is 500 in each case. The comparisons of the singlerun for unlinked data and fullylinked data were made and presented in Figs. 1 and 2.
Consistent with expectations, the unlinked STRSNP panel shows significant difference neither for K (p value = 0.26) (Fig. 1a) or X (p value = 0.13) (Fig. 1b). At the same time, significant LD is detected for both of K (p value < 0.0001) and X (p value < 0.0001) at the fully linked STRSNP panels (Fig. 1c, d). It is contrastive that, for the simulated unlinked panel, the observed distribution of K and X matched the expected one visually under the assumption of mutual independence while, for the fullylinked panel, there is significant offset between the observed and expected distributions.
For the unlinked panel, the test statistic of K is 19.40 and that of X is 33.31, both smaller than the critical value 39.00 and 50.00, respectively (Fig. 2a, b). However, the test values (1,559,984 and 6.8834 × 10^{12} for K and X, respectively) for the fully linked panel are much larger than the critical values (35.00, 52.00 for K and X, respectively) (Fig. 2c, d).
Simulated data with different levels of linkage were tested to determine the type I error and power of the method. Figures 1 and 2 presents the results for completely unlinked and fully linked panels (20 STRs and 10 SNPs). To test different extents of LD more adequately, different numbers of random selected genetic unlinked and fully linked markers were imported to the package and tested for mutual independence. pvalue, which equals to one minus the cumulative probability was chosen as the statistic. Among the 1000 in silico replicates, the percentages of significant cases are recorded in Table 2 for different levels of linkage. In this process, mixed panels made up with equal numbers of SNPs and STRs were simulated, and each level of linkage was set up in three ways: biased to SNPs, biased to STRs, and unbiased. For example, in a panel of 20 markers, 10 SNPs and 10 STRs were selected; if the linkage is set as halflinked in the SNPbiased panel, there would be 10 linked SNPs and 10 unlinked STRs. In contrast, if the panel is STRbiased, 10 linked STRs and 10 unlinked SNPs would be chosen. In the unbiased group, the linked STRs and linked SNPs are always of the same number, which is 5 linked SNPs, 5 linked STRs, 5 unlinked SNPs, and 5 unlinked STRs in the unbiased halflinked panels of 20 markers (Details in Tables 1, 2 and Additional file 14: Table S7).
For the unlinked panels, the proportion of p values smaller than 0.05 was approximately 50 out of 1000 times. As the number of markers increased, the proportions of significant results became closer to 0.05 (Table 2 and Additional file 14: Table S7). The significant cases in the unlink panel are the Type I errors, which indicates the significance level is about 0.05 for this method. In a fully linked dataset, the power of this test was over 50% when one panel had more than 20 markers, and as the sizes of panels increase, the power of K and X is stronger and stronger.
As the visualization of Table 2 and Additional file 14: Table S7, comparison of different levels of linked data is presented in Fig. 3 (Fig. 3). In addition, three linkage bias scenarios were also compared at each level of linkage (Additional file 5: Figure S5), and the comparisons of K and X are shown in Additional file 6: Figure S6.
The power of mixIndependR appears to follow three basic trends: (1) when the number of markers increases, the power of testing increases (Fig. 3); (2) compared to STRs, linkage in SNPs gives more power for linkage tests (Additional file 5: Figure S5); (3) between the two summary statistics, the number of heterozygous loci (K) can detect dependency more often than the number of shared alleles (X) for the same panel (Additional file 6: Figure S6).
When there is only one pair of genetic markers linked, neither of the two methods detected the dependency effectively. In halfquarterlinked panels, the SNPbiased group has a little higher power than STRbiased group around 10–40% on K and 6% to 18% on X; and power of the unbiased group is between SNPbiased and STRbiased groups, but none of the three groups present a strong enough power in halfquarterlinked panels. However, for quarter or higherlevels of linkage both K and X yield power greater than 50% when the number of parkers is no less than 60 in SNPbiased group. In contrast, only the threequarter of linkage and almostlinkage (one pair of markers not linked) can be detected in the STRbiased group. Only with more than 40 markers can the power of STRbiased panels reach 50% and more. In the unbiased group where the number of linked SNPs and linked STRs are equal, K presented more than 50% power when panel sizes were greater than 32 in halflinked panels and greater than 16 in threequarterlinked panels; the power of X is not as strong as K, only greater than 50% when panel sizes are over 60 in halflinked panels and over 32 in threequarterlinked panels. In another direction, the number of shared alleles (X) has a lower power than the number of heterozygous loci (K), but the typeI error is larger for K when the panel size is small (Fig. 3 and Additional file 6: Figure S6).
Afterwards, pure SNP panels were chosen tested to compare summary statistics and other methods. When the panels have more than 10 SNPs the power of both methods are larger than 50%, even in quarterlinked scenarios. For littlelinked panels where only one pair of SNPs in linkage, summary statistics are able to detect with power of about 10–20% when panel size are smaller than twenty SNPs, which is much more powerful than pairwise LD. For quarter and halflinked panels, summary statistics presented their advantage with distinguished power for larger panels. In halflinked panels, summary statistics can detect linkage disequilibrium with power of approximately 75–80% when the sample size is larger than 20 and more than 40–50% in quarterlinked panels when the panel sizes are not smaller than 30. For panels with more than 30 SNPs, the power of summary statistics is larger than 40% and increases with the panel size. When there are more than 20 SNPs, the power is estimated to be 100% for fully linked loci, more than 50% for quarterlinked panels, and nearly 90% for halflinked panels (Additional file 7: Figure S7).
Real data analysis
Furthermore, having been used in the tests on simulated panels, mixIndependR was applied to panels with real data. Based on the SNP + STR reference haplotype panel which was generated by imputing STRs to SNPs [11, 20], a mix panel of 2067 variants including 47 STRs and 2020 SNPs, with a threshold 0.2 for squared pairwise correlation r^{2} (Details of variants selection in Methods). In PCA panel design, this is a threshold for “independent” variants. Refer to the output of \(r^{2}\) table from plink, 0.36% of pairs are detected as pairwise LD (\(r^{2} > 0.2\)) in this panel though. Therefore, we expect detecting this level of linkage disequilibrium with K and X. With a sample size of 2504 individuals, p values of mutual independence test were calculated by K and X. Controlling the panel size for easy comparison in later research, panel size was defined as 100. In other words, 100 markers of the 2067 variants were selected randomly as a sample panel to test, and the process of choose and test was repeated in 1000 times.
As a results, in the 1000 trials 76.1% of p values of K and 19.0% of p values for X are smaller than 0.05, which indicates that the markers of this panel are not mutual independent. In contrast, the number of significant pairwise LDs calculated by GDA is 218 out of 4950 pairs of markers (100 markers were selected randomly in one sample), which is 4.40%. The large difference between the power of X compared to K might result from the fact that majority of the markers are SNPs, the heterozygosity of which data carries more information than number of sharing alleles. In contrast, the pairwise LDs between these markers gave a result of \(r^{2}\) < 0.2, which is the selection rule for this panel. Our new approach with summary performed better than the traditional methods in the panels with little linkage in the real world. In addition, more panels with different threshold of \(r^{2}\) have been designed and the comparison is presented in the section of Discussion.
Discussion
Compared to traditional LD tests (e.g., D′), the approaches presented herein appear to become more powerful as the size of the panel increases. In Fig. 4 presented the comparisons of power between summary statistics and pairwise LD on simulated pure SNP panels with different levels of linkage (Details of calculation in Methods). K and X showed shows more powerful with 10% than pairwise LD in halflinked panels and holds a stronger advantage in quarterlinked panels, where pairwise LD loss its power. For littlelinked panels where there is only one pair of SNPs in linkage, summary statistics can detect linkage with about 20% power for small panel size.
On the other hand, the tests of real data panels have also been completed and compared between the pairwise correlation and summary statistics K and X. With the threshold for \(r^{2}\) set in 4 groups: < 0.2, < 0.4, < 0.6 and < 0.8, four panels in Table 3 were designed. With the threshold lifting, the number of markers selected increase from 2067 to 5754, among which the number of STRs increases from 47 to 115. The percentage of variant pairs with significant LD in each group increases from 0.36 to 21.43%. Though the maximum of correlation was setting higher, the means of \(r^{2}\) and 3rd quarters of \(r^{2}\) remain below 0.2 (Table 3 and Fig. 5a). Using the software GDA, a set of pvalues for pairwise LD were calculated (Fig. 5b). After the Bonferroni correction, about 3–5% pairs of variants are found significant dependent in each test of a panel with 100 variants. Holding the panel size as 100 constant, 10 times of analysis were repeated with different 100 variants which were chosen randomly from each group, and the power of method GDA has been assessed using the formula explained in Methods. Due to the few repeats of experiments, most of the power is below 20%. Though 7 of the 10 repeats at the group of 0.6 have been found as significance, the average of proportion of significant p values after Bonferroni correction is 0.054. The seven proportions defined as dependency panel are range of 0.05 and 0.06. This result might be explained by not enough times of experiments. More trials can be tested, but this method is timeconsuming as one single calculation for pairwise LD of a 100variantpanel needs 1 h and 8 min, without the time of generating and formatting samples. However, in the tests using K and X, linkage disequilibrium was detected. Controlling panel size as 100 markers, the proportion of significant p values (< 0.05) is 96.35% on average for K and 23.80% for X. Across four groups with different threshold of \(r^{2}\) and total panel size, the power of K or X fluctuate in a small scale (\(sd_{K} = 0.016. sd_{X} = 0.029)\). The reason why K shows a much stronger power than X also lies in the large proportion of SNPs in panels. Also, K or X can conduct a single test in 100 times with different random samples selected each time in only 12 and a half minutes for panels with 100 markers.
Therefore, both in simulation and real data, this approach presented a stronger power on detecting linkage disequilibrium in a manner of testing the linkage more than pairwise of a whole panel, regardless of the types of genetic markers.
Conclusions
The R package mixIndependR is available on the Comprehensive R Archive Network (CRAN) at: https://cran.rproject.org/web/packages/mixIndependR/index.html [21] and the development version can be found on Github: https://github.com/ice4prince/mixIndependR.git [22]. This package contributes to the LD test of mixed panels with different types of genetic markers. It permits several new approaches to estimating LD, with the described method permitting LD estimation between heterogeneous marker types (e.g., SNPs and STRs). Instead of pairwise LD, the method tests mutual independence across all the markers of one panel. With new test statistics, this approach improved the power of dependency testing, and succeeded in testing the overall linkage disequilibrium across all sites simultaneously.
Methods
Data representations
In mixIndpendR, dataset to import can be an “. xslx” “.csv” or “vcf” file, with the marker names in the first row, and sample ID in the first column like the example (Table 4). “vcf” file can be imported with the function read_vcf_gt. Allele files where alleles are separated in two different cells needs a conversion by function “makeGenotypes” in genetics[23, 24].
We simulated unlinked and linked data under the WrightFisher neutral model using the software ms [18]; the microsatellite data were converted by microsat [19] from ms format. For data simulation, we chose the average mutation rate (\(\mu\)) 1.3 × 10^{–3} [25] and an effective population (N) size of 3100, the latter of which was estimated from linkage disequilibrium [26]. Thus, to simulate the unlinked STR data the mutation parameter \(\theta { }\left( {\theta = 4{\text{N}}\mu { }} \right)\) is equal to 16.12. In contrast, to simulate SNPs a fixed number of segregating sites was simulated for both unlinked data and linked data.
Real data was downloaded and filtered from the reference panel of Dr. Saini et al. [11] using plink 1.90 [16, 17]. Chromosome 22 was chosen so that fewer variants needs to import, and less time will be spent. Before selecting for different levels of pairwise dependence, variants and samples with more than 1% missing data, with minor allele frequency lower than 0.1, and those who fail in Hardy–Weinberg test at 5%, and with Mendel error rate higher than 0.1 at family level or higher than 0.2 for SNPs, had been filtered out. As to the different levels of linkage panels, selection rules were set using the pairwise correlationr^{2}. Four groups were formed with pairwise correlation (window size 50 kb and step size 10 variants) < 0.2 (2067 variants), < 0.4 (3157 variants), < 0.6 (4278 variants) and < 0.8 (5754 variants), and in each panel there are 47 STRs, 64 STRs, 83 STRs, and 115 STRs, respectively. The LD significant pairs of variants in these groups make up 0.36%, 5.71%, 12.21%, and 21.43% among all variants in each panel, respectively. Furthermore, the pairwise r^{2} values for each group were exported by plink.
The example dataset attached in the package “mixexample” was filtered from chromosome 4 with the same selection rule but with a threshold 0.1 for \(r^{2}\). Among the panel of 7413 variants, 100 markers were selected randomly to make up the example dataset.
Functionalities
The package mixIndependR is made up of two main sections—basic genetic parameters calculation and mutual independence testing. Parameters obtained in the first part can be used in the second section. The software pipeline presented a structure of all the functions (Fig. 6).
Basic genetics
The first part of this package was developed to calculate the basic genetic parameters of a mixed or nonmixed panel, including the allele frequencies (AlleleFreq), the genotype frequencies or expected genotype probabilities (GenotypeFreq), and the Hardy–Weinberg Equilibrium (HWE.Chisq) [8, 27]. Different from other packages or software, these functions for basic genetic parameters can ignore the types of genetic markers and do not need to input the list of marker names, but the separator between alleles needs to be specified.
Mutual independence
Summary statistics design
In traditional statistics, nonrandom associations were tested from pairs. However, mutual independence also included other subsets, like triplets and quartets. As the number of subsets increases, large quantities of free parameters will be generated. For example, for independence of two loci, there would be 3 free parameters if the heterozygosity were chosen as the tested statistics. But for 5 loci where the number of pair comes to 32, there would be 2^{5} − 1 = 31 free parameters in only pairwise independence testing, not to mention more subsets like triplets and quartets. When tens of loci were imported, the parameters would increase to thousands, where even the sample size might not be that large sometimes.
In order to break the large barrier that the number of free parameters might exceed the relatively small number of observations/subjects for the traditional statistic method when the sample size is not big enough, to avoid numerous calculations, and to reduce time consumption, two summary statistics were designed—the number of heterozygous Loci (K) and the number of shared alleles (X) [10].
Under the assumption of mutual independence, the distribution of these summary statistics follows a restricted multinomial distribution. By comparing the observed and expected distribution, the hypothesis for mutual independence could be tested [10].
For the number of heterozygous loci (K), the distribution follows an appropriate binomial distribution of 0 and 1, with the fixed but different probabilities on each trial. Similarly, the distribution of the number of shared alleles(X) follows a “skewed” multinomial distribution of 0, 1, and 2, where the probabilities are specified on each trial.
The number of heterozygous loci (K)
The number of heterozygous loci (K) is the sum of the number of heterozygous loci for each individual, which was denoted as
With the dataset imported, a table for heterozygosity was built by Heterozygous. This function exported a table of 0 and 1, where 0 denoted homozygous and 1 denoted heterozygous, with each row for each individual and each column for each marker. With the table of heterozygous status, the function FreqHetero obtained the observed distribution of number of heterozygous loci for the targeted dataset.
The expected distribution was built according to a recurrence formula with a specially assigned “Start” and “End” [9]. For the first mth loci, there were two possible scenarios to discover r heterozygous loci: 1. the last locus is homozygous and there were r heterozygous loci on the first (m − 1) loci; 2. the last locus is heterozygous and there were (r − 1) heterozygous loci on the first (m − 1) loci.
The vector of heterozygosity was calculated with function RxpHetero in case of Hardy–Weinberg Equilibrium or Disequilibrium with the logic parameter HWE true or false. The heterozygosity was saved into the vector H in the order of loci, and the expected distribution of K was calculated by DistHetero(H).
The number of shared alleles (X)
Similarly, the number of shared alleles (X) is the summation of the number of shared alleles on each locus obtained by comparing each two individuals.
A table of \(X_{{\text{i}}}\) was built by AlleleShare, where a logic parameter “replacement” defining the type of “pick pairs” needs to be clarified as TRUE for pairs with replacement or FALSE for pairs without replacement.
The observed distribution of \(X_{i}\) was built by FreqAlleleShare from the result of AlleleShare. As for the expected distribution, the probability for sharing 0, 1, or 2 alleles on each locus was needed. According to Weir, the expected probabilities of sharing 0, 1, or 2 alleles for two unrelated individuals could be obtained by ExpProAlleleShare, with the allele frequency table from AlleleFreq. On the other hand, for nonideal samples, the real proportions of sharing alleles were also suitable to use, which could be calculated by RealProAlleleShare. With the probability table, an expected distribution of \(X_{i}\) was built by DistAlleleShare by the principles of multinomial distribution
Significance test
With the distributions built, two functions were designed for data visualization: ComposPare_K and ComposPare_X. These functions generated expected frequencies from the probabilities and converted the dataset into a form suitable to ggplot2 [28] or plot in R.
The null hypothesis was that all markers, regardless of which type, are independent from each other. To test the null hypothesis, making comparisons between observed and expected distribution was required. Generally, a multinomial distribution has a fixed probability for each trial. However, in genetics, we cannot predict the distribution of heterozygosity or probability of sharing alleles for an unknown panel under testing. Thus, there were no perfect statistical methods designed for this special problem at this moment.
Despite the lack of existed methodology, with the fixed probability, it was not difficult to find the distribution of the test statistics by large sample simulation.
In this research, chi square value was chosen as the test statistic since the test was for fit of goodness and the distribution was similar to multinomial distribution. To ensure a good approximation for the chi square distribution, the expected numbers of each category were restricted to no less than five. Functions Simulate_DistK and Simulate_DistX built the simulation for K and X, respectively. For each new panel, each new bundle of simulation needs to be built. Via the basic equation of calculating the Chisquare value, a set of Chisquare values were generated by function Dist_SimuChisq. With the set of Chisquare values, a plot of cumulative distribution of \(\chi^{2}\) were drawn clearly, from which the critical value of Chisquare statistic was specified.
Comparison with other software
The R package genetics provides a function LD to test the linkage disequilibrium for all possible pairs of loci in one panel. This function can output D, D′, Pearson’s correlation coefficient, Chisquare statistic for linkage equilibrium (D = D′ = 0) and the p value of Chisquare test for independence. Using the unlinked data and linked data simulated above, a distribution of the proportion of p values smaller than significance level after Bonferroni correction can be obtained. The null hypothesis is that there is no significant LD among all the pairs for unlinked panel, which is \(\Pr \left( {p \text{}values < \frac{0.05}{{number\,of\,pairs}}} \right) = 0\). Under the null hypothesis, even though the markers were simulated on different chromosomes and there should be no association between any pair of them, some random associations may still be generated. In this program, no more than 5% random associations among the 1000 runs was allowed. In other words, if the percentage of significant p values is larger than 0.05, the null hypothesis would be rejected.
Availability of data and materials
The package is available on both CRAN: CRAN—Package mixIndependR (rproject.org) and GitHub(development version): ice4prince/mixIndependR: R Package mixIndependR (github.com) and all the data used in this project are available in “Additional Data and Material” section of GitHub: mixIndependR/Additional Data and Material at main · ice4prince/mixIndependR (github.com).
Abbreviations
 SNP:

Single nucleotide polymorphism
 InDel:

Insertions and deletions
 STR:

Short tandem repeats
 LD:

Linkage disequilibrium
 K:

The number of heterozygous loci
 X:

The number of shared alleles
 CRAN:

The R package mixIndependR, is available on the Comprehensive R Archive Network
 CODIS:

The combined DNA Index System
 CEU:

Northern and Western Europe
 JPT:

Japanese from Tokyo
 HCB:

Han Chinese from Beijing
References
Butler JM, Coble MD, Vallone PM. STRs vs. SNPs: thoughts on the future of forensic DNA testing. Forensic Sci Med Pathol. 2007;3(3):200–5.
Wei T, Liao F, Wang Y, Pan C, Xiao C, Huang D. A novel multiplex assay of SNPSTR markers for forensic purpose. PLoS ONE. 2018;13(7):e0200700.
Wang L, He W, Mao J, Wang H, Jin B, Luo HB, Liang WB, Zhang L. Development of a SNPSTRs multiplex for forensic identification. Forensic Sci Int Genet Suppl Ser. 2015;5:e598–600.
Edge MD, AlgeeHewitt BFB, Pemberton TJ, Li JZ, Rosenberg NA. Linkage disequilibrium matches forensic genetic records to disjoint genomic marker sets. Proc Natl Acad Sci USA. 2017;114(22):5671–6.
Schulze TG, Chen YS, Akula N, Hennessy K, Badner JA, McInnis MG, DePaulo JR, Schumacher J, Cichon S, Propping P, et al. Can longrange microsatellite data be used to predict shortrange linkage disequilibrium? Hum Mol Genet. 2002;11(12):1363–72.
Danecek P, Schiffels S, Durbin R. Multiallelic calling model in bcftools (m). In: June; 2014.
Zheng X, Levine D, Shen J, Gogarten SM, Laurie C, Weir BS. A highperformance computing toolset for relatedness and principal component analysis of SNP data. Bioinformatics. 2012;28(24):3326–8.
Weir BS. Genetic data analysis II: methods for discrete population genetic data. Sunderland: Sinauer Associates; 1996.
Chakraborty R. The distribution of the number of heterozygous Loci in an individual in natural populations. Genetics. 1981;98(2):461–6.
Chakraborty R, Stivers DN, Su B, Zhong Y, Budowle B. The utility of short tandem repeat loci beyond human identification: implications for development of new DNA typing systems. Electrophoresis. 1999;20(8):1682–96.
Saini S, Mitra I, Mousavi N, Fotsing SF, Gymrek M. A reference haplotype panel for genomewide imputation of short tandem repeats. Nat Commun. 2018;9(1):4397.
Delourme R, Falentin C, Fomeju BF, Boillot M, Lassalle G, André I, Duarte J, Gauthier V, Lucante N, Marty A, et al. Highdensity SNPbased genetic map development and linkage disequilibrium assessment in Brassica napus L. BMC Genom. 2013;14(1):120.
Li X, Han Y, Wei Y, Acharya A, Farmer AD, Ho J, Monteros MJ, Brummer EC. Development of an alfalfa SNP array and its use to evaluate patterns of population structure and linkage disequilibrium. PLoS ONE. 2014;9(1):e84329.
Danecek P, Auton A, Abecasis G, Albers CA, Banks E, DePristo MA, Handsaker RE, Lunter G, Marth GT, Sherry ST, et al. The variant call format and VCFtools. Bioinformatics. 2011;27(15):2156–8.
Weir BS. Matching and partiallymatching DNA profiles. J Forensic Sci. 2004;49(5):1009–14.
Purcell S, Neale B, ToddBrown K, Thomas L, Ferreira MAR, Bender D, Maller J, Sklar P, de Bakker PIW, Daly MJ, et al. PLINK: a tool set for wholegenome association and populationbased linkage analyses. Am J Hum Genet. 2007;81(3):559–75.
PLINK 1.90. http://pngu.mgh.harvard.edu/purcell/plink/.
Hudson RR. Generating samples under a WrightFisher neutral model of genetic variation. Bioinformatics. 2002;18(2):337–8.
Simulates the evolution of linked and unlinked microsatellites using the coalescent. https://github.com/mpcox/microsat.
A reference haplotype panel for genomewide imputation of short tandem repeats. http://gymreklab.com/2018/03/05/snpstr_imputation.html.
mixIndependR: genetics and independence testing of mixed genetic panels. https://cran.rproject.org/web/packages/mixIndependR/index.html.
Song B. mixIndependR: genetics and independence testing of mixed genetic panels (Version v0.4.3). In: 2020, December 1.
Gregorius HR. The probability of losing an allele when diploid genotypes are sampled. Biometrics. 1980;36(4):643–52.
genetics: population genetics. https://cran.rproject.org/web/packages/genetics/index.html.
Dauber EM, Bär W, Klintschar M, Neuhuber F, Parson W, Glock B, Mayr WR. Mutation rates at 23 different short tandem repeat loci. Int Congr Ser. 2003;1239:565–7.
Tenesa A, Navarro P, Hayes BJ, Duffy DL, Clarke GM, Goddard ME, Visscher PM. Recent human effective population size estimated from linkage disequilibrium. Genome Res. 2007;17(4):520–6.
Guo SW, Thompson EA. Performing the exact test of Hardy–Weinberg proportion for multiple alleles. Biometrics. 1992;48(2):361–72.
Wickham H. ggplot2: elegant graphics for data analysis. New York: Springer; 2016.
Acknowledgements
This paper is dedicated to the memory of Dr. Ranajit Chakraborty, who conceived of the original idea of this project. BS would like to express my deep gratitude to Professor Chakraborty for his supervision at the very start of this project. BS would like to express my great appreciation to Professor Shande Chen, Dr. Zhengyang Zhou and Dr. Allison Mann for their instructive and contributive suggestions about biostatistics and software. BS would like to thank Dr. Kaili Liu, Danfeng Chen, M.S., and Bingchun Wan, M.S. for their contribution of running scripts. Besides, BS would like to thank Mr. Peter Mosley for his contributive grammar support and great patience.
Funding
No funding was obtained for this study.
Author information
Authors and Affiliations
Contributions
BS developed this method, wrote the software, performed the analysis and the manuscript. AW instructed BS in data simulation and bioinformatics, and inspired BS with the methods of power test. JP supervised the project. All authors have read and approved the manuscript.
Corresponding author
Ethics declarations
Ethics approval and consent to participate
Not applicable.
Consent for publication
Not applicable.
Competing interests
The authors declare that they have no competing interests.
Additional information
Publisher's Note
Springer Nature remains neutral with regard to jurisdictional claims in published maps and institutional affiliations.
Supplementary Information
Additional file 1: Figure S1.
Distribution of number of heterozygous loci (K) for the example dataset. The Xaxis is the number of shared alleles from 0 to 100, and the Yaxis is the observed density or expected probability of each K. The red bar is the expected distribution, and the green bar denotes the observed distribution. The red line is the expected spline for probability of K.
Additional file 2: Figure S2.
Distribution of number of shared alleles (X) for the example dataset. The Xaxis is the number of shared alleles from 0 to 200, and the Yaxis is the observed density or expected probability of each X. The red bar is the expected distribution, and the green bar denotes the observed distribution. The red line is the expected spline for probability of X.
Additional file 3: Figure S3.
Cumulative probability function of Chisquare values for number of heterozygous loci (K) of the example dataset. The Yaxis is the cumulative probability (1 pvalue) for the chisquare value at Xaxis. In this example, the tested chisquare value of K is 77.417 (blue line), with a cumulative probability of 0.924. In contrast, the critical value for pvalue = 0.05 (cumulative probability = 0.95) is 112.9 (red line).
Additional file 4: Figure S4.
Cumulative probability function of Chisquare values for number of shared alleles (X) of the example dataset. The Yaxis is the cumulative probability (1 pvalue) for the chisquare value at Xaxis. In this example, the tested chisquare value of X is 62.299 (blue line), with a cumulative probability of 0.778. In contrast, the critical value for pvalue = 0.05 (cumulative probability = 0.95) is 115 (red line).
Additional file 5: Figure S5.
Summary of power tests for simulated data at different linkage levels for K and X comparison between ‘Bias’. The Xaxis denotes the number of markers in each panel, and the Yaxis is the proportion of significant cases whose pvalue is smaller than 0.05. The colors present different categories of ‘Bias’ when ‘Bias’ = Both, the types of linked markers are both SNPs and STRs with equal numbers; when ‘Bias’ = SNP, the most or all linked markers are SNPs; when ‘Bias’ = STR, the most or all linked markers are STRs. In Fig. 5, the left plots are those for number of heterozygous loci (K) and the right plots are number of shared alleles (X). From the top to the bottom, the levels of linkage increase from “OnePairLinked” to “AlmostLinked”. In the “Onepair/LittleLinked” level, only one pair of markers are linked in each panel; in the “HalfQuarterLinked” level, 12.5% SNPs are linked; in the “QuarterLinked” level, 25% SNPs are linked; in the “ThreeQuarterLinked” level, 75% SNPs are linked; in the “AlmostLinked” level, all except one pair of markers are linked.
Additional file 6: Figure S6.
Comparison of Power for mixed simulated data (‘Bias’ = Both) between number of heterozygous loci (K) and number of shared alleles (X). The Xaxis denotes the number of markers in each panel, and the Yaxis is the proportion of significant cases whose pvalue is smaller than 0.05. “Linkage on Both” means half of the linked markers are SNPs and the other linked markers are STRs. The solid lines are presented the power trends of K, and the dotted lines are the power trends of X. Different colors are different linkage levels: red lines are halflinked panels (50% markers are linked); green lines are QuarterLinked panels (25% markers are linked); blue lines are ThreeQuarterLinked panels (75% markers are linked).
Additional file 7: Figure S7.
Power and significant level of K and X for simulated SNP panels at different linkage levels. The proportions of significant cases out of 1000 trials along different panel size for simulated SNP panels at different linkage levels. In the “Unlinked” level, all markers in each panel are unlinked; in the “Onepair/LittleLinked” level, only one pair of markers are linked in each panel; in the “HalfQuarterLinked” level, 12.5% SNPs are linked; in the “QuarterLinked” level, 25% SNPs are linked; in the “ThreeQuarterLinked” level, 75% SNPs are linked; in the “AlmostLinked” level, all except one pair of markers are linked; in the “FullyLinked” level, all markers in each panel are linked. The axis “Panel Size” denotes the number of the SNPs in each panel.
Additional file 8: Table S1.
Genotypes of example dataset—‘mixexample’. The raw genotypes of the example data. Each row denotes each individual and each column denotes each marker.
Additional file 9: Table S2.
Table of allele frequency (expected) for example dataset ‘mixexample’. Each column denotes each marker. The first column lists all alleles appeared at all loci0, 1, 2, 3, 4, and 5. There is the probability of the allele of this row at the locus of this column.
Additional file 10: Table S3.
Table of heterozygosity for example dataset ‘mixexample’. In each cell, the status of heterozygosity 0 (homozygous) or 1 (heterozygous), for the individual of this row at this locus is presented. Column names are markers’ names, and the row names are individuals.
Additional file 11: Table S4.
Table of shared alleles for example dataset ‘mixexample’. In each cell, the number of shared alleles 0 or 1 or 2, for the pair of individuals of this row at this locus is presented. Column names are markers’ names, and the row names are pairs of individuals.
Additional file 12: Table S5.
Simulations for expected number of heterozygous loci (K) for the example dataset ‘mixexample’. The first row (also the column names) is the number of heterozygous loci (K) from 0 to 100; and the first column is the index of simulations 1 to 500. Each row denotes each simulation and shows one distribution of K.
Additional file 13: Table S6.
Simulations for expected number of shared alleles (X) for the example dataset ‘mixexample’. The first row (also the column names) is the number of shared alleles from 0 to 200; and the first column is the index of simulations 1 to 500. Each row denotes each simulation and shows one distribution of X.
Additional file 14: Table S7.
Summary of power test for simulated mix panels. Full version of Table 2. The first sheet includes all designed panels; and sheet 2 ~ 4 filtered on variable ‘Bias’. Sheet 2 presents the panels when half of linked markers are SNPs and the other half of linked markers are STRs; Sheet 3 presents the panels with more linked SNPs than linked STRs; Sheet 4 presents the panels with more linked STRs than linked SNPs.
Rights and permissions
Open Access This article is licensed under a Creative Commons Attribution 4.0 International License, which permits use, sharing, adaptation, distribution and reproduction in any medium or format, as long as you give appropriate credit to the original author(s) and the source, provide a link to the Creative Commons licence, and indicate if changes were made. The images or other third party material in this article are included in the article's Creative Commons licence, unless indicated otherwise in a credit line to the material. If material is not included in the article's Creative Commons licence and your intended use is not permitted by statutory regulation or exceeds the permitted use, you will need to obtain permission directly from the copyright holder. To view a copy of this licence, visit http://creativecommons.org/licenses/by/4.0/. The Creative Commons Public Domain Dedication waiver (http://creativecommons.org/publicdomain/zero/1.0/) applies to the data made available in this article, unless otherwise stated in a credit line to the data.
About this article
Cite this article
Song, B., Woerner, A.E. & Planz, J. mixIndependR: a R package for statistical independence testing of loci in database of multilocus genotypes. BMC Bioinformatics 22, 12 (2021). https://doi.org/10.1186/s12859020039450
Received:
Accepted:
Published:
DOI: https://doi.org/10.1186/s12859020039450
Keywords
 Linkage disequilibrium
 R package
 Nonrandom association
 Mutual independence
 STRs
 SNPs