snpPower: Power calculations for a single SNP

View source: R/snpPower.R

snpPowerR Documentation

Power calculations for a single SNP

Description

Calculates power for a single SNP. Allows for power computations of several combinations simultaneously.

Usage

snpPower(cases, controls, RR, MAF, alpha = 0.05)

Arguments

cases

A list of the number of case families. Each element contains the number of families of a specified family design. The possible family designs, i.e. the possible names of the elements, are "mfc" (full triad), "mc" (mother-child dyad), "fc" (father-child dyad) or "c" (a single case child).

controls

A list of the number of control families. Each element contains the number of families of a specified family design. The possible family designs are "mfc" (full triad), "mc" (mother-child-dyad), "fc" (father-child dyad), "mf" (mother-father dyad), "c" (a single control child), "m" (a single control mother) or "f" (a single control father).

RR

A numeric vector of the relative risks (the effect sizes of interest).

MAF

A numeric vector of the minor allele frequencies.

alpha

A numeric vector of the Type I Errors. Equals 0.05 by default.

Details

snpPower computes power for a single SNP by counting the number of "real" case alleles, "real" control alleles and pseudo-control alleles. The pseudo-control alleles are the non-transmitted alleles, possibly from both case families and control families. It assumes a multiplicative dose-response model. snpPower uses the asymptotic normal approximation for the natural logarithm of the odds ratio for calculating power (the relative risks and odds ratios are used interchangeably due to the "rare disease assumption").

snpPower allows for power calculations for mixtures of the possible case family designs and control family designs. The argument cases could, for example, consist of a combination of 1000 full case triads (family design "mfc") and 500 single case children (family design "c"). It is also feasible to compute power for several combinations of the input variables simultaneously. See Examples for further details.

Value

snpPower returns a data frame containing the combinations of input variables and the corresponding power calculations.

Author(s)

Miriam Gjerdevik,
with Hakon K. Gjessing
Professor of Biostatistics
Division of Epidemiology
Norwegian Institute of Public Health

hakon.gjessing@uib.no

References

Skare O, Jugessur A, Lie RT, Wilcox AJ, Murray JC, Lunde A, Nguyen TT, Gjessing HK. Application of a novel hybrid study design to explore gene-environment interactions in orofacial clefts. Annals of Human Genetics (2012) 76, pp. 221-236.

Web Site: https://haplin.bitbucket.io

See Also

haplin, snpSampleSize, hapRun, hapPower, hapPowerAsymp

Examples

## Compute power for a single SNP,
## for the combination of 1000 case triads, RR = 1.2, MAF = 0.1 and alpha = 0.05
snpPower(cases = list(mfc = 1000), controls = list(mfc = 0), RR = 1.2, MAF = 0.1)

## Compute power for a single SNP,
## for the combination of 1000 case triads and 500 single case children (altogether),
## 5000 control triads, RR = 1.1, MAF = 0.1 and alpha = 0.05
snpPower(cases = list(mfc = 1000, c = 500), controls = list(mfc=5000),
RR = 1.1, MAF = 0.1, alpha = 0.05)

## Compute power for a single SNP,
## for the combination of 500 case triads, 10000 control triads, 
## relative risk of 1.2 and minor allele frequency of 0.1,
## and also for the combination of 1000 case triads, 10000 control triads,
## relative risk of 1.1 and minor allele frequency of 0.1
snpPower(cases = list(mfc = c(500, 1000)), controls = list(mfc = 10000),
RR = c(1.2, 1.1), MAF = 0.1)


Haplin documentation built on Sept. 11, 2024, 7:13 p.m.