| Title: | Association Studies for multiple SNPs and multiple traits using Generalized Structured Equation Models |
|---|---|
| Description: | The package provides tools to model and test the association between multiple genotypes and multiple traits, taking into account the prior biological knowledge. Genes, and clinical pathways are incorporated in the model as latent variables. The method is based on Generalized Structured Component Analysis (GSCA). |
| Authors: | Hela Romdhani, Stepan Grinek , Heungsun Hwang and Aurelie Labbe. |
| Maintainer: | Hela Romdhani <[email protected]> |
| License: | GPL-3 |
| Version: | 1.39.0 |
| Built: | 2024-07-17 11:34:17 UTC |
| Source: | https://github.com/bioc/ASGSCA |
The package provides tools to model and test the association between multiple genotypes and multiple traits, taking into account the prior biological knowledge. Functional genomic regions, e.g., genes, and clinical pathways are incorporated in the model as latent variables that are not directly observed. The method is based on Generalized Structured Component Analysis (GSCA).
| Package: | ASGSCA |
| Type: | Package |
| Version: | 1.0 |
| Date: | 2014-07-30 |
| License: | GPL-3 |
Hela Romdhani, Stepan Grinek, Heungsun Hwang and Aurelie Labbe.
Maintainer: Hela Romdhani <[email protected]>
Romdhani, H., Hwang, H., Paradis, G., Roy-Gagnon, M.-H. and Labbe, A. (2014). Pathway-based Association Study of Multiple Candidate Genes and Multiple Traits Using Structural Equation Models. Submitted.
data(GenPhen) W0 <- matrix(c(rep(1,2),rep(0,8),rep(1,2),rep(0,8),rep(1,3),rep(0,7),rep(1,2)),nrow=8,ncol=4) B0 <- matrix(c(rep(0,8),rep(1,2),rep(0,3),1,rep(0,2)),nrow=4,ncol=4) #Estimation only GSCA(GenPhen,W0, B0,estim=TRUE,path.test=FALSE) #Estimation and test for all the path coefficients in the model GSCA(GenPhen,W0, B0,estim=TRUE,path.test=TRUE) #Test only GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE) #Give names to the latent variables GSCA(GenPhen,W0, B0,latent.names=c("Gene1","Gene2","Clinical pathway 1","Clinical pathway 2"), estim=TRUE,path.test=TRUE) #Testing only a subset of path coefficients GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE,path=matrix(c(1,2,3,4),ncol=2))data(GenPhen) W0 <- matrix(c(rep(1,2),rep(0,8),rep(1,2),rep(0,8),rep(1,3),rep(0,7),rep(1,2)),nrow=8,ncol=4) B0 <- matrix(c(rep(0,8),rep(1,2),rep(0,3),1,rep(0,2)),nrow=4,ncol=4) #Estimation only GSCA(GenPhen,W0, B0,estim=TRUE,path.test=FALSE) #Estimation and test for all the path coefficients in the model GSCA(GenPhen,W0, B0,estim=TRUE,path.test=TRUE) #Test only GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE) #Give names to the latent variables GSCA(GenPhen,W0, B0,latent.names=c("Gene1","Gene2","Clinical pathway 1","Clinical pathway 2"), estim=TRUE,path.test=TRUE) #Testing only a subset of path coefficients GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE,path=matrix(c(1,2,3,4),ncol=2))
Matrix indicating connections between the latent variables in the path model fitted to QCAHS data, used in the vignette to estimate the path coefficients of the model.
data(B0)data(B0)
A square matrix of dimension 28.
Simulated data (for 999 individuals) of 4 SNPs mapped to 2 different genes and 4 traits involved in 2 different clinical pathways. The data is simulated such that one of the traits is involved in both clinical pathways and that one gene is connected to one of the clinical pathways and the other to both of them. See Figure 2, scenario (g), in Romdhani et al. (2014) for details.
data(GenPhen)data(GenPhen)
A data frame of 8 columns and 999 rows.
Romdhani, H., Hwang, H., Paradis, G., Roy-Gagnon, M.-H. and Labbe, A. (2014). Pathway-based Association Study of Multiple Candidate Genes and Multiple Traits Using Structural Equation Models, submitted.
For a specified structural equation model with latent variables relating the traits and the genotypes, the function GSCA gives estimates of the parameters of the model and performs permutation tests for the association between multiple genotypes and multiple traits (see Romdhani et al., 2014).
GSCA(data,W0, B0,latent.names=NULL,estim=TRUE,path.test=TRUE,path=NULL,nperm=1000)GSCA(data,W0, B0,latent.names=NULL,estim=TRUE,path.test=TRUE,path=NULL,nperm=1000)
data |
data frame containing the observed variables (genotypes and traits). |
W0 |
matrix with 0's and 1's indicating connections between the observed variables (genotypes and traits) and the latent variables (genes and clinical pathways). The rows correspond to the observed variables in the same order as in data; the columns to the latent variables. A value of 1 indicates an arrow from the observed variable in the row to the latent variable in the column. |
B0 |
square matrix with 0's and 1's indicating connections among latent variables (genes and clinical pathways). Both rows and columns correspond to the latent variables. A value of 1 indicates an arrow directed from the latent variable in the row to the latent variable in the column. |
latent.names |
optional vector of characters containing names for the latent variables that will be displayed in the results. If NULL c("Latent1","Latent2",...) will be used. Default is NULL. |
estim |
logical. If TRUE the estimates of the weight and path coefficient are returned. Default is TRUE. |
path.test |
logical. If TRUE tests for path coefficients are performed. Default is TRUE. |
path |
an optional matrix with 2 columns indicating particular connections to be tested. Each row contains the indices of the two latent variables (the gene and the clinical pathway) corresponding to the connection to be tested. If NULL, the test is performed for all gene-clinical pathway connections specified in the model. Default is NULL. |
nperm |
number of permutations. Default is 1000. |
If estim is TRUE, returns a list with 2 items:
Weight |
Matrix of the same dimension as W0 with 1's replaced by weight coefficients estimates. |
Path |
Matrix of the same dimension as B0 with 1's replaced by path coefficients estimates. |
If, path.test is TRUE and path is NULL, the function returns a matrix of the same dimensions as B0 with 1's replaced by the corresponding p-values and 0's replaced by NA's. If path.test is TRUE and path is not NULL, only p-values for the specified path coefficients are returned.
Hela Romdhani, Stepan Grinek, Heungsun Hwang and Aurelie Labbe.
Romdhani, H., Hwang, H., Paradis, G., Roy-Gagnon, M.-H. and Labbe, A. (2014). Pathway-based Association Study of Multiple Candidate Genes and Multiple Traits Using Structural Equation Models. Submitted.
#Scenario (g) in Romdhani et al. (2014): 4 SNPs mapped to 2 genes and 4 #traits involved in 2 clinical pathways #In total: 8 observed variables and 4 latent variables. #One of the traits is involved in both clinical pathways. #One gene is connected to one of the clinical pathways and #the other to both of them. data(GenPhen) W0 <- matrix(c(rep(1,2),rep(0,8),rep(1,2),rep(0,8),rep(1,3),rep(0,7),rep(1,2)),nrow=8,ncol=4) B0 <- matrix(c(rep(0,8),rep(1,2),rep(0,3),1,rep(0,2)),nrow=4,ncol=4) #Estimation only GSCA(GenPhen,W0, B0,estim=TRUE,path.test=FALSE) #Estimation and test for all the path coefficients in the model GSCA(GenPhen,W0, B0,estim=TRUE,path.test=TRUE) #Test only GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE) #Give names to the latent variables GSCA(GenPhen,W0, B0,latent.names=c("Gene1","Gene2","Clinical pathway 1","Clinical pathway 2"), estim=TRUE,path.test=TRUE) #Testing only a subset of path coefficients GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE,path=matrix(c(1,2,3,4),ncol=2))#Scenario (g) in Romdhani et al. (2014): 4 SNPs mapped to 2 genes and 4 #traits involved in 2 clinical pathways #In total: 8 observed variables and 4 latent variables. #One of the traits is involved in both clinical pathways. #One gene is connected to one of the clinical pathways and #the other to both of them. data(GenPhen) W0 <- matrix(c(rep(1,2),rep(0,8),rep(1,2),rep(0,8),rep(1,3),rep(0,7),rep(1,2)),nrow=8,ncol=4) B0 <- matrix(c(rep(0,8),rep(1,2),rep(0,3),1,rep(0,2)),nrow=4,ncol=4) #Estimation only GSCA(GenPhen,W0, B0,estim=TRUE,path.test=FALSE) #Estimation and test for all the path coefficients in the model GSCA(GenPhen,W0, B0,estim=TRUE,path.test=TRUE) #Test only GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE) #Give names to the latent variables GSCA(GenPhen,W0, B0,latent.names=c("Gene1","Gene2","Clinical pathway 1","Clinical pathway 2"), estim=TRUE,path.test=TRUE) #Testing only a subset of path coefficients GSCA(GenPhen,W0, B0,estim=FALSE,path.test=TRUE,path=matrix(c(1,2,3,4),ncol=2))
GSCAestim fits the Generalized Structured Component Analysis (GSCA) model to data on multiple genetic variants and multiple traits (see Romdhani et al., 2014). An Alternating Least-Squares algorithm (ALS) (de Leeuw, Young and Takane, 1976) is used to minimize a global least squares criterion. The ALS algorithm alternates between two main steps until convergence. In the first step, the weight coefficients are fixed, and the path coefficients are updated in the least-squares sense. In the second step, the weights are updated in the least-squares sense for fixed path coefficients.
GSCAestim(data,W0,B0)GSCAestim(data,W0,B0)
data |
Data frame containing the observed variables. |
W0 |
Matrix with 0's and 1's indicating connections between the observed variables (genotypes and traits) and the latent variables (genes and clinical pathways). The rows correspond to the observed variables in the same order as in data; the columns to the latent variables. A value of 1 indicates an arrow from the observed variable in the row to the latent variable in the column. |
B0 |
square matrix with 0's and 1's indicating connections among latent variables (genes and clinical pathways). Both rows and columns correspond to the latent variables. A value of 1 indicates an arrow directed from the latent variable in the row to the latent variable in the column. |
Returns a list with 2 items.
Weight |
Matrix of the same dimension as W0 with 1's replaced by weight coefficients estimates. |
Path |
Matrix of the same dimension as B0 with 1's replaced by path coefficients estimates. |
Hela Romdhani, Stepan Grinek, Heungsun Hwang and Aurelie Labbe
de Leeuw, J., Young, F. W., and Takane, Y. (1976). Additive structure in qualitative data: An alternating least squares method with optimal scaling features. Psychometrika, 41, 471-503.
Romdhani, H., Hwang, H., Paradis, G., Roy-Gagnon, M.-H. and Labbe, A. (2014). Pathway-based Association Study of Multiple Candidate Genes and Multiple Traits Using Structural Equation Models. Submitted.
#Scenario (g) in Romdhani et al. (2014): 4 SNPs mapped to 2 genes #and 4 traits involved in 2 clinical pathways. #In total: 8 observed variables and 4 latent variables. #One of the traits is involved in both clinical pathways. #One gene is connected to one of the clinical pathways and the other #to both of them. data(GenPhen) W0 <- matrix(c(rep(1,2),rep(0,8),rep(1,2),rep(0,8),rep(1,3),rep(0,7),rep(1,2)),nrow=8,ncol=4) B0 <- matrix(c(rep(0,8),rep(1,2),rep(0,3),1,rep(0,2)),nrow=4,ncol=4) res<-GSCAestim(data=GenPhen,W0,B0)#Scenario (g) in Romdhani et al. (2014): 4 SNPs mapped to 2 genes #and 4 traits involved in 2 clinical pathways. #In total: 8 observed variables and 4 latent variables. #One of the traits is involved in both clinical pathways. #One gene is connected to one of the clinical pathways and the other #to both of them. data(GenPhen) W0 <- matrix(c(rep(1,2),rep(0,8),rep(1,2),rep(0,8),rep(1,3),rep(0,7),rep(1,2)),nrow=8,ncol=4) B0 <- matrix(c(rep(0,8),rep(1,2),rep(0,3),1,rep(0,2)),nrow=4,ncol=4) res<-GSCAestim(data=GenPhen,W0,B0)
Dataset contaning some variables of interest from the Quebec Child and Adolescent Health and Social Survey (QCAHS), observed on $1707$ French Canadian participants (860 boys and 847 girls). Detailed descriptions of the QCAHS design and methods can be found in Paradis et al. (2003). The dataset contains 8 traits (z-score transformation standardized for age and sex), 33 SNPs and 2 polymorphisms with more than two alleles.
data(GenPhen)data(GenPhen)
A data frame of 49 columns and 1707 rows.
Romdhani, H., Hwang, H., Paradis, G., Roy-Gagnon, M.-H. and Labbe, A. (2014). Pathway-based Association Study of Multiple Candidate Genes and Multiple Traits Using Structural Equation Models, submitted. Paradis, G., Lambert, M., O'Loughlin, J., Lavallee, C., Aubin, J., Berthiaume, P., Ledoux, M., Delvin, E., Levy, E., and Hanley, J. (2003). The quebec child and adolescent health and social survey: design and methods of a cardiovascular risk factor survey for youth. Can J Cardiol, 19:523-531.
A list of 3 matrices: Weight containing the weight estimates, Path containing path coefficients estimates and pvalues containing p-values for all path coefficients.
data(ResQCAHS)data(ResQCAHS)
A list of 3 matrices.
Matrix indicating connections between the observed variables and the latent variables in the path model fitted to QCAHS data, used in the vignette to estimate the weight coefficients of the model.
data(W0)data(W0)
A matrix of 49 columns and 28 rows.