GSAR (version 1.6.0)

# KStest: Multivariate Kolmogorov-Smirnov Test of Means

## Description

Performs two-sample nonparametric multivariate test of means based on the minimum spanning tree (MST) and Kolmogorov-Smirnov statistic. It tests the null hypothesis that a set of features has the same mean in two conditions versus different means.

## Usage

`KStest(object, group, nperm=1000)`

## Arguments

object
a numeric matrix with columns and rows respectively corresponding to samples and features.
group
a numeric vector indicating group associations for samples. Possible values are 1 and 2.
nperm
number of permutations used to estimate the null distribution of the test statistic. If not given, a default value 1000 is used.

## Value

KStest produces a list with the following components:
statistic
the value of the observed test statistic.
perm.stat
numeric vector of the resulting test statistic for `nperm` random permutations of sample labels.
p.value
p-value indicating the attained significance level.

## Details

This function tests the null hypothesis that a set of features has no shift between two conditions. It performs a two-sample nonparametric multivariate test based on the minimum spanning tree (MST) and Kolmogorov-Smirnov statistic as proposed by Friedman and Rafsky (1979). The MST of the weighted undirectional graph created from the samples is found. The nodes of the MST are ranked based on their position in the MST. The MST is rooted at the node with largest geodisic distance (rank 1) and then nodes are ranked in the High Directed Preorder (HDP) traversal of the tree (Rahmatallah et. al. 2012). The quantity \$d_i = (r_i / n_1) - (s_i / n_2)\$ is calculated where \$r_i\$(\$s_i\$) is the number of nodes (samples) from condition 1(2) which ranked lower than \$i\$, \$1 \le i \le N\$ and \$N\$ is the total number of samples. The Kolmogorov-Smirnov statistic is given by the maximum absolute difference \$D = max|d_i|\$. The performance of this test under different alternative hypotheses was thoroughly examind in Rahmatallah et. al. (2012). The null distribution of the test statistic is estimated by permuting sample labels `nperm` times and calculating the test statistic for each. P-value is calculated as `p.value`=(`b` + 1)/(`nperm` + 1) where `b` is the number of permutations giving a more extreme statistic than the observed test statistic.

## References

Rahmatallah Y., Emmert-Streib F. and Glazko G. (2012) Gene set analysis for self-contained tests: complex null and specific alternative hypotheses. Bioinformatics 28, 3073--3080.

Friedman J. and Rafsky L. (1979) Multivariate generalization of the Wald-Wolfowitz and Smirnov two-sample tests. Ann. Stat. 7, 697--717.

`RKStest`, `WWtest`, `HDP.ranking`.

## Examples

```## generate a feature set of length 20 in two conditions
## each condition has 20 samples
## use multivariate normal distribution
library(MASS)
ngenes <- 20
nsamples <- 40
## let the mean vector have zeros of length 20 both conditions
zero_vector <- array(0,c(1,ngenes))
## set the covariance matrix to be an identity matrix for both conditions
cov_mtrx <- diag(ngenes)
gp <- mvrnorm(nsamples, zero_vector, cov_mtrx)
## apply a mean shift of 3 to half of the features under condition 2
gp[1:20,1:10] <- gp[1:20,1:10] + 3
dataset <- aperm(gp, c(2,1))
## first 20 samples belong to group 1
## second 20 samples belong to group 2
result <- KStest(object=dataset, group=c(rep(1,20),rep(2,20)))
pvalue <- result\$p.value
```