Learn R Programming

rehh (version 2.0.4)

calc_ehh: EHH and iHH computations at a given core SNP

Description

Compute Extended Haplotype Homozygosity (EHH) and integrated EHH (iHH) for a given focal SNP.

Usage

calc_ehh(haplohh, mrk, limhaplo = 2, limehh = 0.05,
    scalegap = NA, maxgap = NA,
    discard_integration_at_border = TRUE, plotehh = TRUE,
    lty = 1, lwd = 1.5, col = c("blue", "red"), xlab = "Position",
    ylab = expression(Extended ~ haplotype ~ homozygosity ~ (italic(EHH))),
    cex.lab = 1.25, main = NA, cex.main = 1.5)

Arguments

haplohh

An object of class haplohh (see data2haplohh).

mrk

Either the number of the marker in the haplohh object (as integer) or its name (as string) to specify the focal marker

limhaplo

Minimal number of haplotypes to continue computing EHH away from the core SNP. Useless, if no missing data. However, when some data are missing, haplotypes with missing data are removed from the computation. Hence as we compute EHH further from the core SNP, less haplotypes are expected

limehh

Limit at which EHH stops to be evaluated

scalegap

Scales gaps larger than the specified size to the specified size (default=NA, i.e. no scaling)

maxgap

Maximum allowed gap in bp between two SNPs below which EHH stops to be evaluated (default=NA, i.e., no limitation)

discard_integration_at_border

If TRUE and if first or last marker or a gap (larger than maxgap) is reached and EHH is greater than limehh, then iHH is set to NA

plotehh

If TRUE, EHH values for both ancestral and derived allele are plotted for each position

lty

Line type for the ancestral and derived allele iHH (respectively) curves

lwd

Line width for the ancestral and derived allele iHH (respectively) curves

col

Color for the ancestral and derived allele iHH (respectively) curves

xlab

Legend for the x--axis

ylab

Legend for the y--axis

cex.lab

Size of the axis legend

main

Main legend of the EHHS plot

cex.main

Size of the main legend

Value

The returned value is a list containing the following elements:

ehh

A matrix of two rows and nsnps columns containing EHH estimates at each chromosome position relative to the focal SNP for the ancestral (first row) and derived (second row) alleles.

nhaplo_eval

A matrix of two rows and nsnps columns containing the number of evaluated haplotypes at each chromosome position relative to the focal SNP for the ancestral (first row) and derived (second row) alleles.

freq_al1

the frequency of the ancestral allele of the focal SNP.

ihh

A vector of two elements corresponding respectively to the iHH (integrated EHH) for the ancestral and derived allele.

Details

EHH are computed at each position upstream and downstream of the focal SNP for both derived and ancestral allele. This allows in turn the computation of the integrated EHH relative to map distances (iHH).

References

Gautier, M. and Naves, M. (2011). Footprints of selection in the ancestral admixture of a New World Creole cattle breed. Molecular Ecology, 20, 3128--3143.

Sabeti, P.C. et al. (2002). Detecting recent positive selection in the human genome from haplotype structure. Nature, 419, 832--837.

Sabeti, P.C. et al. (2007). Genome-wide detection and characterization of positive selection in human populations. Nature, 449, 913--918.

Tang, K. and Thornton, K.R. and Stoneking, M. (2007). A New Approach for Using Genome Scans to Detect Recent Positive Selection in the Human Genome. Plos Biology, 7, e171.

Voight, B.F. and Kudaravalli, S. and Wen, X. and Pritchard, J.K. (2006). A map of recent positive selection in the human genome. Plos Biology, 4, e72.

See Also

calc_ehhs,data2haplohh,scan_hh

Examples

Run this code
# NOT RUN {
#example haplohh object (280 haplotypes, 1424 SNPs)
#see ?haplohh_cgu_bta12 for details
data(haplohh_cgu_bta12)

#computing EHH statisitics for the focal SNP at position 456
# which displays a strong signal of selection
res.ehh<-calc_ehh(haplohh_cgu_bta12,mrk=456)
# }

Run the code above in your browser using DataLab