FbKMO: Optimal KM for Non-continuous Traits in Familial GWAS Data...

Description Usage Arguments Value Examples

View source: R/FbKMO.R

Description

This function (FbKMO) is used to perform the optimal KM analysis for binary traits in familial GWAS data

Usage

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
FbKMO(
  obj,
  genotypes,
  gid,
  weights = NULL,
  acc = 1e-04,
  acc2 = 1e-04,
  r.all = c(0, 0.25, 0.5, 0.75, 1),
  append.write = NULL
)

Arguments

obj

results saved from FbKMO_Null_Model.

genotypes

1st column: gene name; 2nd column: snp name; 3rd-end columns: A matrix of genotypes for each subject (class: data.frame). The order of 3rd-end columns should match id. Coded as 0, 1, 2 and no missing. This genotype file can be a big file containing all genes or it can be files containing one single gene.

gid

A vector of id mapping to samples in genotype file (class: vector). So the order of samples in gid must be the same as the order in genotypes. Make sure it is not a factor. Although gid doesn't have to be in the same order as id, it is suggested to make them sorted in the same order in order to make all files easily to be tracked. No missing.

weights

1st column: gene name; 2nd column: snp name; 3rd column: A vector with the length equal to the number of variants in the test (class: data.frame). Default is Null indicating equal weight for all markers

acc

Accuracy of numerical integration used in Davies' method for individual r.all p-values. Default 1e-4.

acc2

Accuracy of numerical integration used in Davies' method for the final p-value. Default 1e-4.

r.all

A list of predefined proportion of linear kernel and burden test. When r.all=0, regular kernel machine test (FbKM); when r.all=1, burden test.

append.write

The name of pvalue output file. Write out p-values in real time. Don't need to wait until all genes are processed to get the final output.

Value

output: binary trait optimal family KM (Fb-KMO) p-value

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
#########################################################################
### Examples for Binary Traits in Familial GWAS Data using optimal KM ###
#########################################################################
### Subject IDs are numeric ###
data("FbKM_numID")
obj1 <- FbKMO_Null_Model(phenotype=fbkm_n_y$y, id=fbkm_n_y$id, fa=fbkm_n_y$fa,
mo=fbkm_n_y$mo, family="binomial", covariates=NULL)
pvalue1 <- FbKMO(obj=obj1, genotypes=fbkm_n_gene, gid=fbkm_n_geneid$gid, weights=NULL) 
# Read in a list of genes files instead of a big file containing all genes
obj <- FbKMO_Null_Model(phenotype=fbkm_n_y$y, id=fbkm_n_y$id, fa=fbkm_n_y$fa,
mo=fbkm_n_y$mo, family="binomial", covariates=NULL)
gene <- split(fbkm_n_gene, fbkm_n_gene[,1])
for (k in 1:2) {
  gene[[k]]$gene <- as.character(gene[[k]]$gene)
  pvalue1 <- FbKMO(obj=obj, genotypes=gene[[k]], gid=fbkm_n_geneid$gid, weights=NULL) 
}
### Subject IDs are character ###
data("FbKM_charID")
obj1 <- FbKMO_Null_Model(phenotype=fbkm_c_y$y, id=as.character(fbkm_c_y$id),
fa=as.character(fbkm_c_y$fa), mo=as.character(fbkm_c_y$mo), family="binomial",
covariates=NULL)
pvalue1 <- FbKMO(obj=obj1, genotypes=fbkm_c_gene, gid=as.character(fbkm_c_geneid$gid),
weights=NULL)

KMgene documentation built on July 8, 2020, 6:09 p.m.

Related to FbKMO in KMgene...