SKAT_CommonRare_Robust: SNP set test (both common and rare variants) for binary...

View source: R/Joint_CommonRare_Robust.R

SKAT_CommonRare_RobustR Documentation

SNP set test (both common and rare variants) for binary traits with robust region-based methods

Description

This function computes p-values of robust burden test, SKAT, and SKAT-O for binary traits using SPA and ER.

Usage

 
	SKAT_CommonRare_Robust(Z, obj, kernel = "linear.weighted"
	, method="SKAT", r.corr=NULL,weights.beta.rare=c(1,25)
	, weights.beta.common=c(0.5,0.5), weights = NULL
	, CommonRare_Cutoff=NULL, impute.method = "bestguess"
	, is_check_genotype=TRUE,is_dosage = FALSE, missing_cutoff=0.15
	, max_maf=1, estimate_MAF=1)

	SKAT_CommonRare_Robust.SSD.OneSet(SSD.INFO
	, SetID, obj, ..., obj.SNPWeight=NULL)

	SKAT_CommonRare_Robust.SSD.OneSet_SetIndex(SSD.INFO
	, SetIndex, obj, ..., obj.SNPWeight=NULL )
	

 

Arguments

Z

a numeric genotype matrix with each row as a different individual and each column as a separate gene/snp. Each genotype should be coded as 0, 1, 2, and 9 (or NA) for AA, Aa, aa, and missing, where A is a major allele and a is a minor allele. Now we support both matrix and sparse matrix.

obj

output object from SKAT_Null_Model.

kernel

type of kernel (default= "linear.weighted"). The possible choices are "linear" and "linear.weighted".

method

type of gene based test (default= "SKAT"). The possible choices are "SKAT", "Burden" and "SKATO", which represents robust SKAT, Burden and SKAT-O tests, respectively.

r.corr

the ρ parameter for all variants. ρ =0 and 1 indicate SKAT and Burden test, respectively.

weights.beta.rare

a numeric vector of parameters of beta weights for rare variants. It is only used for weighted kernels. If you want to use your own weights, please specify the "weights" parameter.

weights.beta.common

a numeric vector of parameters of beta weights for common variants. It is only used for weighted kernels. If you want to use your own weights, please specify the "weights" parameter.

weights

a numeric vector of weights for the weighted kernels. See SKAT page for details.

CommonRare_Cutoff

MAF cutoff for common vs rare variants (default=NULL). It should be a numeric value between 0 and 0.5, or NULL. When it is NULL, 1/ √{2 SampleSize } will be used.

impute.method

a method to impute missing genotypes (default= "bestguess"). "bestguess" imputes missing genotypes as most likely values (0,1,2), "random" imputes missing genotypes by generating binomial(2,p) random variables (p is the MAF), and "fixed" imputes missing genotypes by assigning the mean genotype value (2p).

is_check_genotype

a logical value indicating whether to check the validity of the genotype matrix Z (default= TRUE). See SKAT page for details.

is_dosage

a logical value indicating whether the matrix Z is a dosage matrix. If it is TRUE, SKAT will ignore “is_check_genotype”.

missing_cutoff

a cutoff of the missing rates of SNPs (default=0.15). Any SNPs with missing rates higher than the cutoff will be excluded from the analysis.

max_maf

a cutoff of the maximum minor allele frequencies (MAF) (default=1, no cutoff). Any SNPs with MAF > cutoff will be excluded from the analysis.

estimate_MAF

a numeric value indicating how to estimate MAFs for the weight calculation and the missing genotype imputation. See SKAT page for details.

SSD.INFO

an SSD_INFO object returned from Open_SSD.

SetID

a character value of Set ID. You can find a set ID of each set from SetInfo object of SSD.INFO. In SKATBinary_Robust function, this parameter is for the internal use only.

SetIndex

a numeric value of Set index. You can find a set index of each set from SetInfo object of SSD.INFO

obj.SNPWeight

output object from Read_SNP_WeightFile (default=NULL). If NULL, the beta weight with the “weights.beta” parameter will be used.

...

further arguments to be passed to “SKATBinary_Robust”

Value

p.value

p-value. It will be the p-value based on robust methods.

p.value_singlevariant

p-value for each single variant in this region-based test.

param$n.marker

a number of SNPs in the genotype matrix.

param$n.marker.test

a number of SNPs used for the test. It can be different from param$n.marker when some markers are monomorphic or have higher missing rates than the missing_cutoff.

param$rho

the ρ parameter for all variants.

n.common

A number of common markers used for the test.

mac.common

The total minor allele count (MAC) of common markers used for the test.

n.rare

A number of rare markers used for the test.

mac.rare

The total minor allele count (MAC) of rare markers used for the test.

Author(s)

Zhangchen Zhao

References

Zhao, Z., Bi, W., Zhou, W., VandeHaar, P., Fritsche, L. G., & Lee, S. (2019). UK-Biobank Whole Exome Sequence Binary Phenome Analysis with Robust Region-based Rare Variant Test. The American Journal of Human Genetics, in press.

Examples



data(SKATBinary.example)
Z<-SKATBinary.example$Z

obj<-SKAT_Null_Model(y ~ x1 + x2, out_type="D", data=SKATBinary.example)

# run SKAT (default method) with Hybrid
out = SKAT_CommonRare_Robust(Z, obj)

# p-value
out$p.value

#
#	Run burden and SKAT

SKAT_CommonRare_Robust(Z, obj, method="Burden")$p.value
SKAT_CommonRare_Robust(Z, obj, method="SKAT")$p.value




SKAT documentation built on Jan. 15, 2023, 5:10 p.m.