Contents

1 Overview

This vignette provides a description of how to use the GENESIS package to run genetic association tests on array (SNP) data. GENESIS uses mixed models for genetic association testing, as PC-AiR PCs can be used as fixed effect covariates to adjust for population stratification, and a kinship matrix (or genetic relationship matrix) estimated from PC-Relate can be used to account for phenotype correlation due to genetic similarity among samples.

2 Data

2.1 Preparing Scan Annotation Data

The fitNullModel function in the GENESIS package reads sample data from either a standard data.frame class object or a ScanAnnotationDataFrame class object as created by the GWASTools package. This object must contain all of the outcome and covariate data for all samples to be included in the mixed model analysis. Additionally, this object must include a variable called “scanID” which contains a unique identifier for each sample in the analysis. While a standard data.frame can be used, we recommend using a ScanAnnotationDataFrame object, as it can be paired with the genotype data (see below) to ensure matching of sample phenotype and genotype data. Through the use of GWASTools, a ScanAnnotationDataFrame class object can easily be created from a data.frame class object. Example R code for creating a ScanAnnotationDataFrame object is presented below. Much more detail can be found in the GWASTools package reference manual.

# mypcair contains PCs from a previous PC-AiR analysis
# pheno is a vector of Phenotype values

# make a data.frame
mydat <- data.frame(scanID = mypcair$sample.id, pc1 = mypcair$vectors[,1], 
                    pheno = pheno)
head(mydat)
##          scanID         pc1      pheno
## NA19919 NA19919 -0.12511091  0.1917327
## NA19916 NA19916 -0.13151738 -0.5687960
## NA19835 NA19835 -0.08832100  0.8734804
## NA20282 NA20282 -0.08617667  0.5787452
## NA19703 NA19703 -0.11969449  1.6116791
## NA19902 NA19902 -0.11458896  0.6663577
# make ScanAnnotationDataFrame
scanAnnot <- ScanAnnotationDataFrame(mydat)
scanAnnot
## An object of class 'ScanAnnotationDataFrame'
##   scans: NA19919 NA19916 ... NA19764 (173 total)
##   varLabels: scanID pc1 pheno
##   varMetadata: labelDescription

2.2 Reading in Genotype Data

The assocTestSingle function in the GENESIS package reads genotype data from a GenotypeData class object as created by the GWASTools package. Through the use of GWASTools, a GenotypeData class object can easily be created from:

  • an R matrix of SNP genotype data
  • a GDS file
  • PLINK files

Example R code for creating a GenotypeData object is presented below. Much more detail can be found in the GWASTools package reference manual.

2.2.1 R Matrix

geno <- MatrixGenotypeReader(genotype = genotype, snpID = snpID, 
                             chromosome = chromosome, position = position, 
                             scanID = scanID)
genoData <- GenotypeData(geno)
  • genotype is a matrix of genotype values coded as 0 / 1 / 2, where rows index SNPs and columns index samples
  • snpID is an integer vector of unique SNP IDs
  • chromosome is an integer vector specifying the chromosome of each SNP
  • position is an integer vector specifying the position of each SNP
  • scanID is a vector of unique individual IDs

2.2.2 GDS files

geno <- GdsGenotypeReader(filename = "genotype.gds")
genoData <- GenotypeData(geno)
  • filename is the file path to the GDS object

2.3 HapMap Data

To demonstrate association testing with the GENESIS package, we analyze SNP data from the Mexican Americans in Los Angeles, California (MXL) and African American individuals in the southwestern USA (ASW) population samples of HapMap 3. Mexican Americans and African Americans have a diverse ancestral background, and familial relatives are present in these data. Genotype data at a subset of 20K autosomal SNPs for 173 individuals are provided as a GDS file.

# read in GDS data
gdsfile <- system.file("extdata", "HapMap_ASW_MXL_geno.gds", package="GENESIS")
HapMap_geno <- GdsGenotypeReader(filename = gdsfile)
# create a GenotypeData class object with paired ScanAnnotationDataFrame
HapMap_genoData <- GenotypeData(HapMap_geno, scanAnnot = scanAnnot)
HapMap_genoData
## An object of class GenotypeData 
##  | data:
## File: /tmp/RtmpQLD4Sg/Rinst274c43486667/GENESIS/extdata/HapMap_ASW_MXL_geno.gds (901.8K)
## +    [  ] *
## |--+ sample.id   { Int32,factor 173 ZIP(40.9%), 283B } *
## |--+ snp.id   { Int32 20000 ZIP(34.6%), 27.1K }
## |--+ snp.position   { Int32 20000 ZIP(34.6%), 27.1K }
## |--+ snp.chromosome   { Int32 20000 ZIP(0.13%), 103B }
## \--+ genotype   { Bit2 20000x173, 844.7K } *
##  | SNP Annotation:
## NULL
##  | Scan Annotation:
## An object of class 'ScanAnnotationDataFrame'
##   scans: NA19919 NA19916 ... NA19764 (173 total)
##   varLabels: scanID pc1 pheno
##   varMetadata: labelDescription

2.4 Reading in the GRM from PC-Relate

A mixed model for genetic association testing typically includes a genetic relationship matrix (GRM) to account for genetic similarity among sample individuals. If we are using kinship coefficient estimates from PC-Relate to construct this GRM, then the function pcrelateToMatrix should be used to provide the matrix in the appropriate format for fitNullModel.

# mypcrel contains Kinship Estimates from a previous PC-Relate analysis
myGRM <- pcrelateToMatrix(mypcrel)
myGRM[1:5,1:5]
## 5 x 5 Matrix of class "dsyMatrix"
##              NA19625      NA19649      NA19650      NA19651      NA19652
## NA19625  0.974456064 -0.004663156 -0.005306781 -0.011126288 -0.001972720
## NA19649 -0.004663156  1.035460076  0.559304965 -0.006295991 -0.024657329
## NA19650 -0.005306781  0.559304965  1.048759571 -0.003821181  0.003267858
## NA19651 -0.011126288 -0.006295991 -0.003821181  1.005181224 -0.002982152
## NA19652 -0.001972720 -0.024657329  0.003267858 -0.002982152  0.975252269

Note that both the row and column names of this matrix are the same scanIDs as used in the scan annotation data.

3 Mixed Model Association Testing

There are two steps to performing genetic association testing with GENESIS. First, the null model (i.e. the model with no SNP genotype term) is fit using the fitNullModel function. Second, the output of the null model fit is used in conjunction with the genotype data to quickly run SNP-phenotype association tests using the assocTestSingle function. There is a computational advantage to splitting these two steps into two function calls; the null model only needs to be fit once, and SNP association tests can be paralelized by chromosome or some other partitioning to speed up analyses (details below).

3.1 Fit the Null Model

The first step for association testing with GENESIS is to fit the mixed model under the null hypothesis that each SNP has no effect. This null model contains all of the covariates, including ancestry representative PCs, as well as any random effects, such as a polygenic effect due to genetic relatedness, but it does not include any SNP genotype terms as fixed effects.

Using the fitNullModel function, random effects in the null model are specified via their covariance structures. This allows for the inclusion of a polygenic random effect using a kinship matrix or genetic relationship matrix (GRM).

3.1.1 Quantitative Phenotypes

A linear mixed model (LMM) should be fit when analyzing a quantitative phenotype. The example R code below fits a basic null mixed model.

# fit the null mixed model
nullmod <- fitNullModel(scanAnnot, outcome = "pheno", covars = "pc1", 
                        cov.mat = myGRM, family = gaussian)
## [1]    0.4545551    0.4545551 -240.5575300    1.0876208
## [1]    0.4486279    0.4998503 -240.1282254    1.0321271
## [1]    0.04160355    0.80831685 -237.57533297    1.07321454
## [1]    0.09833582    0.80899450 -237.49821429    1.00619714
## [1]    0.1009434    0.8120545 -237.4981395    1.0000399
## [1]    0.1007007    0.8123235 -237.4981384    1.0000000
## [1]    0.1007343    0.8122913 -237.4981384    1.0000000
## [1]    0.1007297    0.8122957 -237.4981384    1.0000000
## [1]    0.1007304    0.8122951 -237.4981384    1.0000000
  • the first argument is the class ScanAnnotationDataFrame or data.frame object containing the sample data
  • outcome specifies the name of the outcome variable in scanAnnot
  • covars specifies the names of the covariates in scanAnnot
  • cov.mat specifies the covariance structures for the random effects included in the model
  • family should be gaussian for a quantitative phenotype, specifying a linear mixed model

The Average Information REML (AIREML) procedure is used to estimate the variance components of the random effects. When verbose = TRUE, the variance component estimates, the log-likelihood, and the residual sum of squares in each iteration are printed to the R console (shown above). In this example, Sigma^2_A is the variance component for the random effect specified in cov.mat, and Sigma^2_E is the residual variance component.

3.1.1.1 Multiple Fixed Effect Covariates

The model can be fit with multiple fixed effect covariates by setting covars equal to vector of covariate names. For example, if we wanted to include the variables “pc1”, “pc2”, “sex”, and “age” all as covariates in the model:

nullmod <- fitNullModel(scanAnnot, outcome = "pheno", 
                        covars = c("pc1","pc2","sex","age"), 
                        cov.mat = myGRM, family = gaussian)

3.1.1.2 Multiple Random Effects

The model also can be fit with multiple random effects. This is done by setting cov.mat equal to a list of matrices. For example, if we wanted to include a polygenic random effect with covariance structure given by the matrix “myGRM” and a household random effect with covariance structure specified by the matrix “H”:

nullmod <- fitNullModel(scanAnnot, outcome = "pheno", covars = "pc1",
                        cov.mat = list("GRM" = myGRM, "House" = H), 
                        family = gaussian)

The names of the matrices in cov.mat determine the names of the variance component parameters. Therefore, in this example, the output printed to the R console will include Sigma^2_GRM for the random effect specified by “myGRM”, Sigma^2_House for the random effect specified by “H”, and Sigma^2_E for the residual variance component.

Note: the row and column names of each matrix used to specify the covariance structure of a random effect in the mixed model must be the unique scanIDs for each sample in the analysis.

3.1.1.3 Heterogeneous Residual Variances

LMMs are typically fit under an assumption of constant (homogeneous) residual variance for all observations. However, for some outcomes, there may be evidence that different groups of observations have different residual variances, in which case the assumption of homoscedasticity is violated. group.var can be used in order to fit separate (heterogeneous) residual variance components by some grouping variable. For example, if we have a categorical variable “study” in our scanAnnot, then we can estimate a different residual variance component for each unique value of “study” by using the following code:

nullmod <- fitNullModel(scanAnnot, outcome = "pheno", covars = "pc1", 
                        cov.mat = myGRM, family = gaussian, 
                        group.var = "study")

In this example, the residual variance component Sigma^2_E is replaced with group specific residual variance components Sigma^2_study1, Sigma^2_study2, …, where “study1”, “study2”, … are the unique values of the “study” variable.

3.1.2 Binary Phentoypes

Ideally, a generalized linear mixed model (GLMM) would be fit for a binary phenotype; however, fitting a GLMM is much more computationally demanding than fitting an LMM. To provide a compuationally efficient approach to fitting such a model, fitNullModel uses the penalized quasi-likelihood (PQL) approximation to the GLMM (Breslow and Clayton). The implementation of this procedure in GENESIS is the same as in GMMAT (Chen et al.), and more details can be found in that manuscript. If our outcome variable, “pheno”, were binary, then the same R code could be used to fit the null model, but with family = binomial.

nullmod <- fitNullModel(scanAnnot, outcome = "pheno", covars = "pc1", 
                        cov.mat = myGRM, family = binomial)

Multiple fixed effect covariates and multiple random effects can be specified for binary phenotypes in the same way as they are for quantitative phenotypes. group.var does not apply here.

3.2 Run SNP-Phenotype Association Tests

The second step for association testing with GENESIS is to use the fitted null model to test the SNPs in the GenotypeData object for association with the specified outcome variable. This is done with the assocTestSingle function. Both (approximate) Wald and score tests are available, but the Wald test can only be performed when family = gaussian in the null model. Otherwise, the use of assocTestSingle for running association tests with a quantitative or binary phenotype is identical.

Before we can run an association test on a GenotypeData object, we much first decide how many SNPs we want to read at a time. We do this by creating a GenotypeBlockIterator object that defines blocks of SNPs. The default setting is to read 10,000 SNPs in each block, but this may be changed with the snpBlock argument.

genoIterator <- GenotypeBlockIterator(HapMap_genoData, snpBlock=5000)

The example R code below runs the association analyses using the null model we fit using fitNullModel in the previous section.

assoc <- assocTestSingle(genoIterator, null.model = nullmod, test = "Wald")
  • genoData is a GenotypeData class object
  • null.model is the output from fitNullModel
  • test specifies whether to use a “Wald” or “Score” test

By default, the function will perform association tests at all SNPs in the genoData object. However, for computational reasons it may be practical to parallelize this step, partitioning SNPs by chromosome or some other pre-selected grouping. If we only want to test a pre-specified set of SNPs, this can be done by passing a vector of snpID values to the snpInclude argument when we create the iterator.

# mysnps is a vector of snpID values for the SNPs we want to test
genoIterator <- GenotypeBlockIterator(HapMap_genoData, snpInclude=mysnps)
assoc <- assocTestSingle(genoIterator, null.model = nullmod, test = "Wald")

3.3 Output

3.3.1 The Null Model

The fitNullModel function will return a list with a large amount of data. Some of the more useful output for the user includes:

  • varComp: the variance component estimates for the random effects
  • fixef: a data.frame with point estimates, standard errors, test statistics, and p-values for each of the fixed effect covariates
  • fitted.values: the fitted values from the model
  • resid.marginal and resid.conditional: the marginal and conditional residuals from the model

There are also metrics assessing model fit such as the log-likelihood (logLik), restricted log-likelihood (logLikR), and the Akaike information criterion (AIC). Additionally, there are some objects such as the working outcome vector (workingY) and the Cholesky decomposition of the inverse of the estimated phenotype covariance matrix (cholSigmaInv) that are used by the assocTestSingle function for association testing. Further details describing all of the output can be found with the command help(fitNullModel).

3.3.2 The Association Tests

The assocTestSingle function will return a data.frame with summary information from the association test for each SNP. Each row corresponds to a different SNP.

head(assoc)
##   variant.id chr pos n.obs      freq         Est    Est.SE  Wald.Stat
## 1          1   1   1   173 0.3901734  0.01596095 0.1156612  0.1379975
## 2          2   1   2   173 0.4942197 -0.08262055 0.1094157 -0.7551071
## 3          3   1   3   173 0.1011561 -0.04614918 0.1842710 -0.2504420
## 4          4   1   4   173 0.4855491 -0.08010814 0.1061834 -0.7544318
## 5          5   1   5   172 0.4447674  0.09760757 0.1149197  0.8493546
## 6          6   1   6   172 0.2093023  0.19060885 0.1352096  1.4097282
##   Wald.pval
## 1 0.8902424
## 2 0.4501847
## 3 0.8022456
## 4 0.4505900
## 5 0.3956840
## 6 0.1586200
  • variant.id: the unique snp ID
  • chr: the chromosome
  • pos: the position
  • n.obs: the number of samples analyzed at that SNP
  • freq: the frequency of the tested (“A”) allele
  • Est: the effect size estimate (beta) for that SNP
  • Est.SE: the estimated standard error of the effect size estimate
  • Wald.Stat: the chi-squared Wald test statistic
  • Wald.pval: the p-value based on the Wald test statistic

Note: when test = "Score" in assocTestSingle (rather than test = "Wald"), then Est, SE, Wald.Stat, and Wald.pval are replaced by:

  • Score: the value of the score function
  • Score.SE: the estimated standard error of the score
  • Score.Stat: the chi-squared score test statistic
  • Score.pval: the p-value based on the score test statistic

Further details describing all of the output can be found with the command help(assocTestSingle).

4 Heritability Estimation

It is often of interest to estimate the proportion of the total phenotype variability explained by the entire set of genotyped SNPs avaialable; this provides an estimate of the narrow sense heritability of the trait. One method for estimating heritability is to use the variance component estimates from the null mixed model. GENESIS includes the varCompCI function for computing the proportion of variance explained by each random effect along with 95% confidence intervals.

varCompCI(nullmod, prop = TRUE)
##             Proportion   Lower 95  Upper 95
## V_A          0.1103259 -0.2197907 0.4404425
## V_resid.var  0.8896741  0.5595575 1.2197907

When additional random effects are included in the model (e.g. a shared household effect), varCompCI will also return the proportion of variability explained by each of these components.

Note: varCompCI can not compute proportions of variance explained when heterogeneous residual variances are used in the null model (i.e. group.var is used in fitNullModel). Confidence intervals can still be computed for the variance component estimates on the original scale by setting prop = FALSE.

Note: variance component estimates are not interpretable for binary phenotypes when fit using the PQL method implemented in fitNullModel; proportions of variance explained should not be calculated for these models.

5 References