powerLMEnoCov {powerEQTL} | R Documentation |
Power Calculation for Simple Linear Mixed Effects Model Without Covariate
Description
Power calculation for simple linear mixed effects model without covariate. This function can be used to calculate one of the 3 parameters (power, sample size, and minimum detectable slope) by setting the corresponding parameter as NULL and providing values for the other 2 parameters.
Usage
powerLMEnoCov(
slope,
n,
m,
sigma.y,
power = NULL,
rho = 0.8,
FWER = 0.05,
nTests = 1,
n.lower = 2.01,
n.upper = 1e+30)
Arguments
slope |
numeric. Slope under alternative hypothesis. |
n |
integer. Total number of subjects. |
m |
integer. Number of pairs of replicates per subject. |
sigma.y |
numeric. Standard deviation of the outcome y. |
power |
numeric. Desired power. |
rho |
numeric. Intra-class correlation (i.e., correlation between
|
FWER |
numeric. Family-wise Type I error rate. |
nTests |
integer. Number of tests (e.g., number of genes in differential expression analysis based on scRNAseq to compare gene expression before and after treatment). |
n.lower |
numeric. Lower bound of the total number of subjects. Only used when calculating total number of subjects. |
n.upper |
numeric. Upper bound of the total number of subjects. Only used when calculating total number of subjects. |
Details
In an experiment, there are samples. For each sample, we get
pairs of replicates. For each pair, one replicate will receive no treatment. The other
replicate will receive treatment. The outcome is the expression of a gene. The overall goal of the experiment is to check if the treatment affects gene expression level or not. Or equivalently, the overall goal of the experiment is to test if the mean within-pair difference of gene expression is equal to zero or not. In the design stage, we would like to calculate the power/sample size of the experiment for testing if the mean within-pair difference of gene expression is equal to zero or not.
We assume the following linear mixed effects model to characterize the
relationship between the within-pair difference of gene expression and
the mean of the within-pair difference
:
where
and
,
,
is the number of
subjects,
is the number of pairs of replicates per subject,
is the within-pair difference of outcome value for the
-th pair of the
-th subject.
We would like to test the following hypotheses:
and
where . If we reject the null hypothesis
based on a sample, we then get evidence that the treatment affects
the gene expression level.
We can derive the power calculation formula:
where
and
and is the upper
percentile of the standard normal distribution,
, nTests is the number of
tests,
and
is the intra-class correlation.
Value
power if the input parameter power = NULL
.
sample size (total number of subjects) if the input parameter n = NULL
;
minimum detectable slope if the input parameter slope = NULL
.
Author(s)
Xianjun Dong <XDONG@rics.bwh.harvard.edu>, Xiaoqi Li<xli85@bwh.harvard.edu>, Tzuu-Wang Chang <Chang.Tzuu-Wang@mgh.harvard.edu>, Scott T. Weiss <restw@channing.harvard.edu>, Weiliang Qiu <weiliang.qiu@gmail.com>
References
Dong X, Li X, Chang T-W, Scherzer CR, Weiss ST, and Qiu W. powerEQTL: An R package and shiny application for sample size and power calculation of bulk tissue and single-cell eQTL analysis. Bioinformatics, 2021;, btab385
Examples
n = 17
m = 5
sigma.y = 0.68
slope = 1.3*sigma.y
print(slope)
# estimate power
power = powerLMEnoCov(
slope = slope,
n = n,
m = m,
sigma.y = sigma.y,
power = NULL,
rho = 0.8,
FWER = 0.05,
nTests = 20345)
print(power)
# estimate sample size (total number of subjects)
n = powerLMEnoCov(
slope = slope,
n = NULL,
m = m,
sigma.y = sigma.y,
power = 0.8721607,
rho = 0.8,
FWER = 0.05,
nTests = 20345)
print(n)
# estimate slope
slope = powerLMEnoCov(
slope = NULL,
n = n,
m = m,
sigma.y = sigma.y,
power = 0.8721607,
rho = 0.8,
FWER = 0.05,
nTests = 20345)
print(slope)