ta.test: t_alpha-test for testing difference between two conditions...

Description Usage Arguments Details Value Note Author(s) References See Also Examples

View source: R/ta.test.R

Description

t_α-test is a modified t-test of Gosset(1908).

Usage

1
2
3
ta.test(X, nci=NULL, na, nb, alpha=0.05, paired=FALSE, eqv=TRUE,
LOG=c("NULL","LOG2","LOG","LOG10"),
 alternative = c("two.sided", "less", "greater"), distr="norm")

Arguments

X

a numeric vector data or a numeric matrix (two columns) dataset with two conditions or groups A and B having sample size na and nb, respectively. X is also a datasheet of multiple variables (for example, genes ) with two groups A and B and information columns(see an example Ecadherin)

nci

a numeric int value, column numbers for strings or information of data. If X is a numeric vector data or a numeric matrix (two columns) dataset, then nci=NULL, otherwise, nci is non-zeror int, meaning that at least one column is reserved as information of data

na

numeric constant, sample size in condition A

nb

numeric constant, sample size in condition B

alpha

a numeric constant, statistical cutoff for significance level. If dataset X is multiple variables (rows) (variable number is over 1000), then alpha is taken default values of 0.05 and 0.01.

paired

a logical indicating whether you want a paired t-test.

eqv

a logical variable indicating whether to treat the two variances as being equal. If TRUE then the pooled variance is used to estimate the variance otherwise the Welch (or Satterthwaite) approximation to the degrees of freedom is used.

LOG

logarithm: if data are not taken logarithm convertion, then LOG=NULL , if data are converted into logarithm with base 10, 2 or natural logarithm, then correspondingly, LOG="LOG10", "LOG2" or "LOG".

alternative

a character string specifying the alternative hypothesis, must be one of "two.sided" (default), "greater" or "less". User can specify just the initial letter.

distr

data distribution for estimating omega (ω). Default is normal distribution. In current version, we just consider three types of distributions: "negative distribution"(or "NB"), "norm"(or "normal"), and "unif"("uniform"). User can choose one of them according to user's data distribution.

Details

The formula interface is only applicable for the 2-sample tests.
alternative = "greater" is the alternative that x has a larger mean than y.
If paired is TRUE then both x and y must be specified and they must be the same length. Missing values are silently removed (in pairs if paired is TRUE).
If var.equal is TRUE then the pooled estimate of the variance is used. By default, if var.equal is FALSE, then the variance is estimated separately for both groups and the Welch modification to the degrees of freedom is used.
If the input data are effectively constant (compared to the larger of the two means) an error is generated.
When pooled variance is larger, ttest is equvalent to t.test; When pooled variance is small, t-tavalue of ttest is smaller than than that of t.test; When the pooled variance is zeror, t-value of t.test is not defined but tvalue of ttest is still defined.
Omega is dependent on alpha value.
ta.test can be used to test for differentially expressed genes in microarray data, proteomic data and RPPA data but cannot be used to count data of RNA-seq reads.

Value

If X is single-hypothesis test data, then a list similar to t.test containing the following components: statistic
the value of the t-statistic.
parameter
the degrees of freedom for the t-statistic.
p.value
the p-alue for the test.
conf.int
a confidence interval for the mean appropriate to the specified alternative hypothesis.
estimate
the estimated mean or difference in means depending on whether it was a one-sample test or a two-sample test.
null.value
the specified hypothesized value of the mean or mean difference depending on whether it was a one-sample test or a two-sample test.
alternative
a character string describing the alternative hypothesis.
method
a character string indicating what type of t-test was performed.
data.name
a character string giving the name(s) of the data.
omega a threshold for rho in tatest.
If X is microarray, RPPA data, then a list is datasheet including t01,pv01, t05 and p05 columns

Note

LOG choice must be the same with log transformation of data.

Author(s)

Yuande Tan
[email protected]

References

Gosset, W.S, "Probable error of a correlation coefficient". Biometrika. 1908,6 (2/3): 302-310.

See Also

t.test,ttest

Examples

1
2
3
4
5
6
7
8
9
X<-c(112,122,108,127)
Y<-c(302, 314,322,328)
dat<-cbind(X,Y)
ta.test(X=dat,nci=NULL, na=4,nb=4, eqv=TRUE, 
alpha=0.05, LOG="NULL", alternative = "two.sided")

data(Ecadherin)
res<-ta.test(X=Ecadherin[1:2000,],nci=1, na=3,nb=3, eqv=TRUE, 
LOG="LOG2", alternative = "two.sided")

tatest documentation built on July 18, 2018, 5:03 p.m.