qpTopPairs: Report pairs of variables

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

View source: R/qpgraph.R

Description

Report a top number of pairs of variables according to either some association measure and/or occurring in a given reference graph.

Usage

1
2
3
4
qpTopPairs(measurementsMatrix=NULL, refGraph=NULL, n=6L, file=NULL,
           decreasing=FALSE, pairup.i=NULL, pairup.j=NULL,
           annotation=NULL, fcOutput=NULL, fcOutput.na.rm=FALSE,
           digits=NULL)

Arguments

measurementsMatrix

matrix containing the measure of association between all pairs of variables.

refGraph

a reference graph containing the pairs that should be reported and provided either as an adjacency matrix, a graphNEL-class object or a graphAM-class object.

n

number of pairs to report, 6 by default, use Inf for reporting all of them.

file

file name to dump the pairs information as tab-separated column text.

decreasing

logical; if TRUE then the measurements are employed to be ordered in decreasing order; if FALSE then in increasing order.

pairup.i

subset of vertices to pair up with subset pairup.j.

pairup.j

subset of vertices to pair up with subset pairup.i.

annotation

name of an annotation package to transform gene identifiers into gene symbols when variables correspond to genes.

fcOutput

output of qpFunctionalCoherence.

fcOutput.na.rm

flag set to TRUE when pairs with NA values from fcOutput should not be reported; FALSE (default) otherwise.

digits

number of decimal digits reported in the values of measurementsMatrix and functional coherence values. By default digits=NULL, and therefore, no rounding is performed.

Details

The measurementsMatrix should be symmetric and may have also contain NA values which will not be taken into account. That is an alternative way to restricting the variable pairs with the parameters pairup.i and pairup.j. The same holds for refGraph. One of these two, should be specified.

Value

The ranking of pairs is invisibly returned.

Author(s)

R. Castelo

See Also

qpGraph qpPrecisionRecall qpFunctionalCoherence

Examples

1
qpTopPairs(matrix(runif(100), nrow=10, dimnames=list(1:10,1:10)))

qpgraph documentation built on Jan. 10, 2021, 2:01 a.m.