tni.constructor {RTN}R Documentation

A constructor for objects of class TNI.

Description

This function is the main entry point of the TNI pipeline.

Usage

tni.constructor(expData, regulatoryElements, rowAnnotation=NULL, colAnnotation=NULL, 
cvfilter=TRUE, verbose=TRUE)

Arguments

expData

a gene expression matrix.

regulatoryElements

a vector of regulatory elements (e.g. transcription factors).

rowAnnotation

an optional data frame or matrix with probe-to-gene annotation (e.g. probe-to-gene information). Column 1 must provide all probe ids listed in the 'gexp' matrix. Ideally, col1 = <PROBEID>, col2 = <GENEID>, and col3 = <SYMBOL>. Additional annotation can be included in the data frame and will be passed to the resulting TNI object. Furthermore, in order to eventually use the TNI object in AVS-class methods, it should also include chromosome coordinates: columns <CHROM>, <START> and <END>. Values in <CHROM> should be listed in [chr1, chr2, chr3, ..., chrX], while <START> and <END> correspond to chromosome positions (see avs.evse).

colAnnotation

This option has not yet been implemented!

cvfilter

a single logical value specifying to remove duplicated genes in the gene expression matrix using the probe-to-gene annotation. In this case, 'rowAnnotation' must be provided, with col1 = <PROBEID> and col2 = <GENEID>. The decision is made based on the maximum dinamic range (i.e. keeping the probes with max coefficient of variation across all samples).

verbose

a single logical value specifying to display detailed messages (when verbose=TRUE) or not (when verbose=FALSE).

Author(s)

Mauro Castro

See Also

TNI-class

Examples


data(dt4rtn)

#--- select 5 regulatoryElements to illustrate the constructor
tfs4test <- dt4rtn$tfs[c("PTTG1","E2F2","FOXM1","E2F3","RUNX2")]
#--- run constructor
rtni <- tni.constructor(expData=dt4rtn$gexp, 
                  regulatoryElements=tfs4test, 
                  rowAnnotation=dt4rtn$gexpIDs)

[Package RTN version 2.4.6 Index]