PREDAResults-class {PREDA} | R Documentation

## Class "PREDAResults" ~is used to manage the PREDA analysis output

### Description

this class is used to manage the basic PREDA analysis output including smoothened statistic, pvalues and qvalues.

### Objects from the Class

Objects can be created by calls of the form `new("PREDAResults", ids, chr, start, end, strand, chromosomesNumbers, chromosomesLabels, position, optionalAnnotations, optionalAnnotationsHeaders, analysesNames, testedTail, smoothStatistic, pvalue, qvalue)`.

### Slots

`analysesNames`:

  Object of class `"character"` a character vector of unique names associated to each column of smoothStatistic, pvalue and qvalue matrices. This is just a name that is used to identify each analysis.

`testedTail`:

  Object of class `"character"` a character describing what tail of the statistic distribution will be analyzed during PREDA analysis. Possible values are "upper", "lower" or "both". Anyway we strongly recommend using PREDA analysis only

`smoothStatistic`:

  Object of class `"matrix"` a numeric matrix containing smoothed observed statistics as obtained from PREDA analysis. The smoothed statistics must be provided as a matrix of numeric values, with a number of rows equal to the length of "ids" slot and a number of columns equal to the length of "analysesNames" slot.

`pvalue`:

  Object of class `"matrix"` a numeric matrix containing unadjusted gene-centered pvalues as obtained from PREDA analysis. The pvalue matrix must be provided as a matrix of numeric values, with a number of rows equal to the length of "ids" slot and a number of columns equal to the length of "analysesNames" slot.

`qvalue`:

  Object of class `"matrix"` a numeric matrix containing adjusted gene-centered pvalues as obtained from PREDA analysis: i.e. usually FDR adjusted pvalues, but other multiple testing methods could be adopted as well The qvalue matrix must be provided as a matrix of numeric values, with a number of rows equal to the length of "ids" slot and a number of columns equal to the length of "analysesNames" slot.

`position`:

  Object of class `"integer"` a numeric vector of reference genomic positions that will be associated and used for each genomic feature under investigation for smoothing data during PREDA analysis.

`ids`:

  Object of class `"character"` a character vector of unique identifiers for the genomic features under investigation

`chr`:

  Object of class `"integer"` a numeric vector representing the chromosome where each ids is mapped. Please note that chromosome usually not represented with a number must will be comverted to a number as well. e.g. for Human, chromsomomees X and Y will be converted to chromsomes 23 and 24 respectively. User defined options will allow this conversion during GenomicAnnotations objects initialization.

`start`:

  Object of class `"integer"` a numeric vector of start genomic position for each genomic feature under investigation (i.e. gene, transcript, SNP or other elements).

`end`:

  Object of class `"integer"` a numeric vector of end genomic position for each genomic feature under investigation (i.e. gene, transcript, SNP or other elements).

`strand`:

  Object of class `"numeric"` a numeric vector of strand genomic position for each genomic feature under investigation: value 1 is used for "plus" (forward) strand and value -1 for "minus" (reverse) strand. User defined options will allow the conversion to this format during GenomicAnnotations objects initialization.

`chromosomesNumbers`:

  Object of class `"numeric"` a numeric vector containing the list of chromosomes for which genomic annotations are provided in the GenomicAnnotations object. Each chromosome is represented just once in increasing order. Please note that chromosome usually not represented with a number must will be comverted to a number as well. e.g. for Human, chromsomomees X and Y will be converted to chromsomes 23 and 24 respectively.

`chromosomesLabels`:

  Object of class `"character"` a character vector containing the list of chromosomes for which genomic annotations are provided in the GenomicAnnotations object. Each chromosome is represented just once in the same order as reported in chromosomesNumbers slot. This slot is actually used just to provide a label for each associated chromosome number, in case that some non numeric chromsome is used (e.g. to preserve the correspondence between chr 23 and the actual chr X in Human)

`optionalAnnotations`:

  Object of class `"matrix"` optional annotations associated to the genomic features can be managed along with genomic positions annotations. E.g. GeneSymbol or EntrezGene ids can be associated to gene realted GenomicAnnotaitons objects. These additional annotations are not mandatory (the default value for this slot is NULL) The additional annotations must be provided as a matrix of character, with a number of rows equal to the length of "ids" slot and a number of columns equal to the length of "optionalAnnotationsHeaders" slot.

`optionalAnnotationsHeaders`:

  Object of class `"character"` character vector containing the names associated to optional annotations. Please avoid using spaces in annotations names.

### Extends

Class `"GenomicAnnotationsForPREDA"`, directly. Class `"GenomicAnnotations"`, by class "GenomicAnnotationsForPREDA", distance 2.

### Methods

GenomicAnnotationsSortAndCleanNA

  `signature(.Object = "PREDAResults")`: sort annotations according to selected chromosomes and to remove genes containing any NA annotation field

initialize

  `signature(.Object = "PREDAResults")`: initialize method for PREDAResults objects

PREDAResults2dataframe

  `signature(.Object = "PREDAResults")`: extact preda results statistics as a data frame object

PREDAResults2GenomicRegions

  `signature(.Object = "PREDAResults")`: identify significant genomic regions from a PREDAResults object

PREDAResults2GenomicRegionsSingle

  `signature(.Object = "PREDAResults")`: identify significant genomic regions from a single analysis in a PREDAResults object

PREDAResults2PREDADataAndResults

  `signature(.Object = "PREDAResults")`: merge PREDAResults and input statistics to create a PREDADataAndResults object

PREDAResultsGetObservedFlags

  `signature(.Object = "PREDAResults")`: extract genomic positions with significant alterations as a matrix of flags from a PREDAResults object

### Note

This class is better described in the package vignette

### Author(s)

Francesco Ferrari

### See Also

`"GenomicAnnotations"`, `"GenomicAnnotationsForPREDA"`, `GenomicAnnotationsSortAndCleanNA`, `PREDAResults2dataframe`, `PREDAResults2GenomicRegions`, `PREDAResults2GenomicRegionsSingle`, `PREDAResults2PREDADataAndResults`, `PREDAResultsGetObservedFlags`

### Examples

    showClass("PREDAResults")

[Package PREDA version 1.30.0 Index]