NChannelSet-class          package:Biobase          R Documentation

_C_l_a_s_s _t_o _c_o_n_t_a_i_n _d_a_t_a _f_r_o_m _m_u_l_t_i_p_l_e _c_h_a_n_n_e_l _a_r_r_a_y _t_e_c_h_n_o_l_o_g_i_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     Container for high-throughput assays and experimental meta-data.
     Data are from experiments where a single 'chip' contains several
     (more than 1) different 'channels'. All channels on a chip have
     the same set of'features'. An experiment consists of a collection
     of several N-channel chips; each chip is a 'sample'.

     An 'NChannelSet' provides a way to coordinate assay data
     (expression values) with phenotype information and references to
     chip annotation data; it extends the 'eSet' class.

     An 'NChannelSet' allows channels to be extracted (using the
     'channels' method, mentioned below), and subsets of features or
     samples to be selected (using '[<features>, <samples>]').
     Selection and subsetting occur so that relevant phenotypic data is
     maintained by the selection or subset.

_O_b_j_e_c_t_s _f_r_o_m _t_h_e _C_l_a_s_s:

     Objects can be created by calls of the form 'new("NChannelSet",
     assayData, phenoData, ...)'. See the examples below.

_S_l_o_t_s:


     '_a_s_s_a_y_D_a_t_a': Object of class 'AssayData', usually an environment
          containing matricies of identical size. Each matrix
          represents a single channel. Columns in each matrix
          correspond to samples, rows to features. Once created,
          'NChannelSet' manages coordination of samples and channels.


     '_p_h_e_n_o_D_a_t_a': Object of class 'AnnotatedDataFrame'.

          The 'data' component of the 'AnnotatedDataFrame' is
          'data.frame' with number of rows equal to the number of
          samples. Columns of the 'data' component correspond to
          measured covariates.

          The 'varMetadata' component consists of mandatory columns
          'labelDescription' (providing a textual description of each
          column label in the 'data' component) and 'channel'. The
          'channel' of 'varMetadata' is a 'factor', with levels equal
          to the names of the 'assayData' channels, plus the special
          symbol '_ALL_'. The 'channel' column is used to indicate
          which channel(s) the corresponding column in the 'data'
          component of 'AnnotatedDataFrame' correspond;  the '_ALL_'
          symbol indicates that the 'data' column is applicable to all
          channels. 'varMetadata' may contain additional columns with
          arbitrary information.

          Once created, 'NChannelSet' coordinates selection and
          subsetting of channels in 'phenoData'.


     '_f_e_a_t_u_r_e_D_a_t_a': Object of class 'AnnotatedDataFrame', used to
          contain feature data that is unique to this experiment;
          feature-level descriptions common to a particular chip are
          usually referenced through the 'annotation' slot.

     '_e_x_p_e_r_i_m_e_n_t_D_a_t_a': Object of class 'MIAME' containing descriptions
          of the experiment.


     '_a_n_n_o_t_a_t_i_o_n': Object of class '"character"'. Usually a length-1
          character string identifying the chip technology used during
          the experiment. The annotation string is used to retrieve
          information  about features, e.g., using the 'annotation'
          package.

     '.___c_l_a_s_s_V_e_r_s_i_o_n__': Object of class 'Versions', containing
          automatically created information about the class definition
          Biobase package version, and other information about the user
          system at the time the instance was created. See
          'classVersion' and 'updateObject' for examples of use.


_E_x_t_e_n_d_s:

     Class '"eSet"', directly. Class '"VersionedBiobase"', by class
     "eSet", distance 2. Class '"Versioned"', by class "eSet", distance
     3.

_M_e_t_h_o_d_s:

     Methods with class-specific functionality:

     '_c_h_a_n_n_e_l(_o_b_j_e_c_t, _n_a_m_e, ...)' 'signature(object="NChannelSet",
          name="character")'. Return an 'ExperessionSet' created from
          the channel and corresponding phenotype of argument 'name'.
          'name' must have length 1. Arguments '...' are rarely used,
          but are passed to the 'ExpressionSet' constructor, for
          instance to influence 'storage.mode'.

     '_c_h_a_n_n_e_l_N_a_m_e_s(_o_b_j_e_c_t)' 'signature(object = "NChannelSet")'. Obtain
          names of channels contained in 'object'.

     '_s_e_l_e_c_t_C_h_a_n_n_e_l_s(_o_b_j_e_c_t, _n_a_m_e_s, ...' 'signature(object =
          "NChannelSet", names = "character")'. Create a new
          'NChannelSet' from 'object', containing only channels in
          'names'. The '...' is not used by this method.

     '_o_b_j_e_c_t[_f_e_a_t_u_r_e_s, _s_a_m_p_l_e_s]' 'signature(object = "NChannelSet",
          features = "ANY", samples = "ANY")'. Create a new
          'NChannelSet' from 'object', containing only elements
          matching 'features' and 'samples'; either index may be
          missing, or a character, numeric, or logical vector.

     '_s_a_m_p_l_e_N_a_m_e_s(_o_b_j_e_c_t) <- _v_a_l_u_e' 'signature(object = "NChannelSet",
          value = "list")' assign each (named) element of 'value' to
          the 'sampleNames' of the correspondingly named elements of
          'assayData' in 'object'.


     Methods with functionality derived from 'eSet': 'annotation',
     'assayData', 'assayData<-', 'classVersion', 'classVersion<-',
     'dim', 'dims', 'experimentData', 'featureData', 'phenoData',
     'phenoData<-', 'pubMedIds', 'sampleNames', 'sampleNames<-',
     'storageMode', 'varMetadata', 'isCurrent', 'isVersioned',
     'updateObject'.

     Additional methods: 'coerce' (\sQuote(as), to convert between
     objects, if possible), 'initialize' (used internally for creating
     objects), 'show' (invoked automatically when the object is
     displayed to the screen)

_A_u_t_h_o_r(_s):

     Martin Morgan <mtmorgan@fhcrc.org>

_S_e_e _A_l_s_o:

     'eSet', 'ExpressionSet'.

_E_x_a_m_p_l_e_s:

     ## An empty NChannelSet
     obj <- new("NChannelSet")

     ## An NChannelSet with two channels (R, G) and no phenotypic data
     obj <- new("NChannelSet",
                R=matrix(0,10,5), G=matrix(0,10,5))
     ## An NChannelSet with two channels and channel-specific phenoData
     R <- matrix(0, 10, 3, dimnames=list(NULL, LETTERS[1:3]))
     G <- matrix(1, 10, 3, dimnames=list(NULL, LETTERS[1:3]))
     assayData <- assayDataNew(R=R, G=G)
     data <- data.frame(ChannelRData=numeric(ncol(R)),
                        ChannelGData=numeric(ncol(R)),
                        ChannelRAndG=numeric(ncol(R)))
     varMetadata <- data.frame(labelDescription=c(
                                 "R-specific phenoData",
                                 "G-specific phenoData",
                                 "Both channel phenoData"),
                               channel=factor(c("R", "G", "_ALL_")))
     phenoData <- new("AnnotatedDataFrame",
                      data=data, varMetadata=varMetadata)
     obj <- new("NChannelSet",
                assayData=assayData, phenoData=phenoData)
     obj

     ## G channel as NChannelSet
     selectChannels(obj, "G")

     ## G channel as ExpressionSet
     channel(obj, "G")

     ## Samples "A" and "C"
     obj[,c("A", "C")]

