makenull: Generate a mutual information null distribution from a gene...

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


In order to determine the statistical significance of the mutual information values between genes we test for each pair of genes the following null hypothesis.

H_0^I: The mutual information between gene i and j is zero.

Because we are using a nonparametric test we need to obtain the corresponding null distribution for H_0^I from a randomization of the data.

'makenull' performs a randomization with the formulated null hypothesis by permuting the sample and gene labels for all genes of the entire expression matrix at once. The vector of the mutual information null distribution is obtained from repeated randomizations for a given number of iterations.


makenull(dataset, nullit=NA, estimator="pearson", disc="equalwidth")



gene expression data matrix


nullit defines the size of the generated null distribution vector used for hypothesis testing of significant edges inferred by c3net. The null distribution of mutual information is generated from sample and gene label randomization.

default number of iterations: nullit=ceiling(10^5/(((genes*genes)/2)-genes)) genes: number of genes


estimators for continuous variables "pearson" (default), "spearman", "kendall", "spearman"

estimators for discrete variables "emp", "mm","sg","shrink"


only required for discrete estimators, method for discretize function (infotheo package) "equalfreq" (default), "equalwidth", "globalequalwith"


The function 'makenull' generates a numeric vector of the mutual information null distribution estimated from a given number of randomized datasets.


Ricardo de Matos Simoes <> Frank Emmert-Streib <>


de Matos Simoes R, Emmert-Streib F., Bagging statistical network inference from large-scale gene expression data., PLoS One. 2012;7(3):e33624. Epub 2012 Mar 30.

See Also

c3mtc bc3net


 null=makenull(expmat, nullit=5)

Search within the bc3net package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.