create_LDprofile: Creates an LD profile

Description Usage Arguments Details Value References See Also Examples

View source: R/create_LDprofile.R

Description

An LD (linkage disequilibrium) profile is a look-up table containing the expected correlation between SNPs given the genetic distance between them. The use of an LD profile can increase the accuracy of results by taking into account the expected correlation between SNPs. This function aids the user in creating their own LD profile.

Usage

1
create_LDprofile(dist, x, bin_size, max_dist = NULL, beta_params = FALSE)

Arguments

dist

A numeric vector, or a list of numeric vectors, containing the genetic distance for each SNP.

x

A matrix of SNP values, or a list of matrices. Columns represent chromosomes; rows are SNP locations. Hence, the number of rows should equal the length of the dist vector. SNPs should all be biallelic.

bin_size

The size of each bin, in the same units as dist.

max_dist

Optional. The maximum genetic distance to be considered. If this is not supplied, it will default to the maximum distance in the dist vector.

beta_params

Optional. Beta parameters are calculated if this is set to TRUE. Default is FALSE.

Details

The input for dist and x can be lists. This allows multiple datasets to be used in the creation of the LD profile. For example, using all 22 autosomes from the human genome would involve 22 different distance vectors and SNP matrices. Both lists should be the same length and should correspond exactly to each other (i.e. the distances in each element of dist should go with the SNPs in the same element of x)

In the output, bins represent lower bounds. The first bin contains pairs where the genetic distance is greater than or equal to 0 and less than bin_size. The final bin contains pairs where the genetic distance is greater than or equal to max_dist-bin_size and less than max_dist. If the max_dist is not an increment of bin_size, it will be adjusted to the next highest increment. The final bin will be the bin that max_dist falls into. For example, if the max_dist is given as 4.5 and the bin_size is 1, the final bin will be 4. max_dist should be big enough to cover the genetic distances between pairs of SNPs within the window size given when the Zalpha statistics are run. Any pairs with genetic distances bigger than max_dist will be assigned the values in the maximum bin of the LD profile.

By default, Beta parameters are not calculated. To fit a Beta distribution to the expected correlations, needed for the Zalpha_BetaCDF and Zbeta_BetaCDF statistics, beta_params should be set to TRUE and the package 'fitdistrplus' must be installed.

Ideally, an LD profile would be generated using data from a null population with no selection, For example by using a simulation if the other population parameters are known. However, often these are unknown or complex, so generating an LD profile using the same data as is being analysed is acceptable, as long as the bins are large enough.

Value

A data frame containing an LD profile that can be used by other statistics in this package.

References

Jacobs, G.S., T.J. Sluckin, and T. Kivisild, Refining the Use of Linkage Disequilibrium as a Robust Signature of Selective Sweeps. Genetics, 2016. 203(4): p. 1807

See Also

Zalpha_expected, Zalpha_rsq_over_expected, Zalpha_log_rsq_over_expected, Zalpha_Zscore, Zalpha_BetaCDF, Zbeta_expected, Zbeta_rsq_over_expected, Zbeta_log_rsq_over_expected, Zbeta_Zscore, Zbeta_BetaCDF, Zalpha_all.

Examples

1
2
3
4
5
6
7
8
## load the snps example dataset
data(snps)
## Create an LD profile using this data
create_LDprofile(snps$cM_distances,as.matrix(snps[,3:12]),0.001)
## To get the Beta distribution parameter estimates, the fitdistrplus package is required
if (requireNamespace("fitdistrplus", quietly = TRUE)==TRUE) {
  create_LDprofile(snps$cM_distances,as.matrix(snps[,3:12]),0.001,beta_params=TRUE)
}

zalpha documentation built on Nov. 27, 2021, 9:06 a.m.