eSet {Biobase}R Documentation

Class to Contain High-Throughput Assays and Experimental Metadata

Description

Container for high-throughput assays and experimental metadata. Classes derived from eSet contain one or more identical-sized matricies as assayData elements. Derived classes (e.g., ExpressionSet-class, SnpSet-class) specify which elements must be present in the assayData slot.

eSet object cannot be instantiated directly; see the examples for useage.

Creating Objects

eSet is a virtual class, so instances cannot be created.

Objects created under previous definitions of eSet-class can be coerced to classes derived based on eSet using updateOldESet.

Slots

Introduced in eSet:

assayData:
Contains matrices with equal dimensions, and with column number equal to nrow(phenoData). Class:AssayData-class
phenoData:
Contains variables describing sample (i.e., columns in assayData) phenotypes.Class: AnnotatedDataFrame-class
experimentData:
Contains details of experimental methods. Class: MIAME-class
annotation:
Label associated with the annotation package used in the experiment. Class:character

Methods

Methods defined in derived classes (e.g., ExpressionSet-class, SnpSet-class) may override the methods described here.

Class-specific methods:

sampleNames(object) and sampleNames(object)<-value:
Coordinate accessing and setting sample names in assayData and phenoData
featureNames(object), featureNames(object) <- value:
Coordinate accessing and setting of feature names (e.g, genes, probes) in assayData.
dims(object):
Access the common dimensions (dim) or column numbers (ncol), or dimensions of all memebers (dims) of assayData.
phenoData(object), phenoData(object) <- value:
Access and set phenoData.
varLabels(object), varLabels(eSet, value)<-:
Access and set variable labels in phenoData.
varMetadata(object), varMetadata(object) <- value:
Access and set descriptions of variables in phenoData.
pData(object), pData(object) <- value:
Access and set sample data information
varMetadata(object), varMetadata(eSet,value)
Access and set metadata describing variables reported in pData
experimentData(object),experimentData(object) <- value:
Access and set details of experimental methods
description(object),description(object) <- value:
Synonymous with experimentData; included for compatibility with exprSet.
notes(object),notes(object) <- value:
signature(object="eSet", value="list") Retrieve and set unstructured notes associated with eSet.
pubMedIds(object), pubMedIds(eSet,value)
Access and set PMIDs in experimentData.
abstract(object):
Access abstract in experimentData.
annotation(object), annotation(object) <- value
Access and set annotation label indicating package used in the experiment.
combine(eSet,eSet):
Combine two eSet objects. To be combined, eSets must have identical numbers of featureNames, distinct sampleNames, and identical annotation.
storageMode(object), storageMode(eSet,character)<-:
Change storage mode of assayData. Can be used to 'unlock' environments, or to change between list and environment modes of storing assayData.
reporterNames(object), reporterNames(object) <- value:
DEPRECATED, see featureNames

Standard generic methods:

initialize(object):
Object instantiation, can be called by derived classes but not usually by the user.
validObject(object):
Validity-checking method, ensuring (1) all assayData components have the same number of features and samples; (2) the number and names of phenoData rows match the number and names of assayData columns
show(object)
Informatively display object contents.
dim(object), ncol
Access the common dimensions (dim) or column numbers (ncol), of all memebers (dims) of assayData.
object[(index):
Conducts subsetting of matrices and phenoData components
object, eSet$<-
Access and set named columns in phenoData

Additional functions:

updateOldESet
Update versions of eSet constructued using listOrEnv as assayData slot (before May, 2006)

Author(s)

Biocore team

See Also

Method use in ExpressionSet-class. Related classes AssayData-class, AnnotatedDataFrame-class, MIAME-class. Derived classes ExpressionSet-class, SnpSet-class. To update objects from previous class versions, see updateOldESet.

Examples

# create an instance of an existing derived class
new("ExpressionSet")

# update existing exprSet-like class to existing derived class
data(sample.exprSet)
expressionSet <- as(sample.exprSet,"ExpressionSet")
expressionSet

# update previous eSet-like class oldESet to existing derived class
## Not run: updateOldESet(oldESet, "ExpressionSet")

# create a new, ad hoc, class, for personal use
# all methods outlined above are available automatically
setClass("MySet", contains="eSet")
new("MySet")

# Create a more robust class, with initialization and validation methods
# to ensure assayData contains specific matricies
setClass("TwoColorSet", contains="eSet")

setMethod("initialize", "TwoColorSet",
          function(.Object,
                   phenoData = new("AnnotatedDataFrame"),
                   experimentData = new("MIAME"),
                   annotation = character(),
                   R = new("matrix"),
                   G = new("matrix"),
                   Rb = new("matrix"),
                   Gb = new("matrix"),
                   ... ) {
            callNextMethod(.Object,
                           phenoData = phenoData,
                           experimentData = experimentData,
                           annotation = annotation,
                           R=R, G=G, Rb=Rb, Gb=Gb,
                           ...)
          })

setValidity("TwoColorSet", function(object) {
  assayDataValidMembers(assayData(object), c("R", "G", "Rb", "Gb"))
})

new("TwoColorSet")

# eSet objects cannot be instantiated directly, only derived objects
try(new("eSet"))

[Package Biobase version 1.10.1 Index]