eSet                 package:Biobase                 R Documentation

_C_l_a_s_s _t_o _C_o_n_t_a_i_n _H_i_g_h-_T_h_r_o_u_g_h_p_u_t _A_s_s_a_y_s _a_n_d _E_x_p_e_r_i_m_e_n_t_a_l _M_e_t_a_d_a_t_a

_D_e_s_c_r_i_p_t_i_o_n:

     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.

_C_r_e_a_t_i_n_g _O_b_j_e_c_t_s:

     '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'.

_S_l_o_t_s:

     Introduced in 'eSet':

     '_a_s_s_a_y_D_a_t_a': Contains matrices with equal dimensions, and with
          column number equal to 'nrow(phenoData)'.
          Class:'AssayData-class'

     '_p_h_e_n_o_D_a_t_a': Contains variables describing sample (i.e., columns
          in 'assayData') phenotypes. Class: 'AnnotatedDataFrame-class'

     '_f_e_a_t_u_r_e_D_a_t_a': Contains variables describing features (i.e., rows
          in 'assayData') unique to this experiment. Use the
          'annotation' slot to efficiently reference feature data
          common to the annotation package used in the experiment.
          Class: 'AnnotatedDataFrame-class' 

     '_e_x_p_e_r_i_m_e_n_t_D_a_t_a': Contains details of experimental methods. Class:
          'MIAME-class'

     '_a_n_n_o_t_a_t_i_o_n': Label associated with the annotation package used in
          the experiment. Class: 'character'

     '._c_l_a_s_s_V_e_r_s_i_o_n': Character vector describing the R and Biobase
          version number used to created the instance. Intended for
          developer use. Class: 'Versions-class' 

_M_e_t_h_o_d_s:

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

     Class-specific methods:

     '_s_a_m_p_l_e_N_a_m_e_s(_o_b_j_e_c_t)' _a_n_d '_s_a_m_p_l_e_N_a_m_e_s(_o_b_j_e_c_t)<-_v_a_l_u_e': Coordinate
          accessing and setting sample names in 'assayData' and
          'phenoData'

     '_f_e_a_t_u_r_e_N_a_m_e_s(_o_b_j_e_c_t)', '_f_e_a_t_u_r_e_N_a_m_e_s(_o_b_j_e_c_t) <- _v_a_l_u_e': 
          Coordinate accessing and setting of feature names (e.g,
          genes, probes) in 'assayData'.

     '_d_i_m_s(_o_b_j_e_c_t)': Access the common dimensions ('dim') or column
          numbers ('ncol'), or dimensions of all memebers ('dims') of
          'assayData'.

     '_p_h_e_n_o_D_a_t_a(_o_b_j_e_c_t)', '_p_h_e_n_o_D_a_t_a(_o_b_j_e_c_t) <- _v_a_l_u_e': Access and set
          'phenoData'. Adding new columns to 'phenoData' is often more
          easily done with 'eSetObject[["columnName"]] <- value'.

     '_p_D_a_t_a(_o_b_j_e_c_t)', '_p_D_a_t_a(_o_b_j_e_c_t) <- _v_a_l_u_e': Access and set sample
          data information. Adding new columns to 'pData' is often more
          easily done with 'eSetObject[["columnName"]] <- value'.

     '_v_a_r_M_e_t_a_d_a_t_a(_o_b_j_e_c_t)', '_v_a_r_M_e_t_a_d_a_t_a(_e_S_e_t,_v_a_l_u_e)' Access and set
          metadata describing variables reported in 'pData'

     '_v_a_r_L_a_b_e_l_s(_o_b_j_e_c_t)', '_v_a_r_L_a_b_e_l_s(_e_S_e_t,              _v_a_l_u_e)<-': 
          Access and set variable labels in 'phenoData'.

     '_f_e_a_t_u_r_e_D_a_t_a(_o_b_j_e_c_t)', '_f_e_a_t_u_r_e_D_a_t_a(_o_b_j_e_c_t) <- _v_a_l_u_e': Access and
          set 'featureData'.

     '_f_D_a_t_a(_o_b_j_e_c_t)', '_f_D_a_t_a(_o_b_j_e_c_t) <- _v_a_l_u_e': Access and set feature
          data information.

     '_f_v_a_r_M_e_t_a_d_a_t_a(_o_b_j_e_c_t)', '_f_v_a_r_M_e_t_a_d_a_t_a(_e_S_e_t,_v_a_l_u_e)' Access and set
          metadata describing features reported in 'fData'

     '_f_v_a_r_L_a_b_e_l_s(_o_b_j_e_c_t)', '_f_v_a_r_L_a_b_e_l_s(_e_S_e_t, _v_a_l_u_e)<-': Access and set
          variable labels in 'featureData'. 

     '_a_s_s_a_y_D_a_t_a(_o_b_j_e_c_t), _a_s_s_a_y_D_a_t_a(_o_b_j_e_c_t) <- _v_a_l_u_e': 'signature(object
          = "eSet", value = "AssayData")': Access and replace the
          'AssayData' slot of an 'eSet' instance. 'assayData' returns a
          list or environment; elements in 'assayData' not accessible
          in other ways (e.g., via 'exprs' applied directly to the
          'eSet') can most reliably be accessed with, e.g.,
          'assayData(obj)[["se.exprs"]]'.

     '_e_x_p_e_r_i_m_e_n_t_D_a_t_a(_o_b_j_e_c_t)','_e_x_p_e_r_i_m_e_n_t_D_a_t_a(_o_b_j_e_c_t) <- _v_a_l_u_e': Access
          and set details of experimental methods

     '_d_e_s_c_r_i_p_t_i_o_n(_o_b_j_e_c_t)','_d_e_s_c_r_i_p_t_i_o_n(_o_b_j_e_c_t) <- _v_a_l_u_e': Synonymous
          with experimentData; included for compatibility with
          'exprSet'.

     '_n_o_t_e_s(_o_b_j_e_c_t)','_n_o_t_e_s(_o_b_j_e_c_t) <- _v_a_l_u_e': 
          'signature(object="eSet", value="list")' Retrieve and set
          unstructured notes associated with 'eSet'.
          'signature(object="eSet", value="character")' As with
          value="list", but _append_ value to current list of notes.

     '_p_u_b_M_e_d_I_d_s(_o_b_j_e_c_t)', '_p_u_b_M_e_d_I_d_s(_e_S_e_t,_v_a_l_u_e)' Access and set PMIDs
          in 'experimentData'.

     '_a_b_s_t_r_a_c_t(_o_b_j_e_c_t)': Access abstract in 'experimentData'.

     '_a_n_n_o_t_a_t_i_o_n(_o_b_j_e_c_t)', '_a_n_n_o_t_a_t_i_o_n(_o_b_j_e_c_t) <- _v_a_l_u_e' Access and set
          annotation label indicating package used in the experiment.

     '_p_r_e_p_r_o_c(_o_b_j_e_c_t)', '_p_r_e_p_r_o_c(_o_b_j_e_c_t) <- _v_a_l_u_e': 
          'signature(object="eSet", value="list")' Access and set
          'preprocessing' information in the 'MIAME-class' object
          associated with this 'eSet'.

     '_c_o_m_b_i_n_e(_e_S_e_t,_e_S_e_t)': Combine two 'eSet' objects. To be combined,
          eSets must have identical numbers of 'featureNames', distinct
          'sampleNames', and identical 'annotation'.

     '_s_t_o_r_a_g_e_M_o_d_e(_o_b_j_e_c_t)', '_s_t_o_r_a_g_e_M_o_d_e(_e_S_e_t,_c_h_a_r_a_c_t_e_r)<-': Change
          storage mode of 'assayData'. Can be used to 'unlock'
          environments, or to change between 'list' and 'environment'
          modes of storing 'assayData'.

     '_r_e_p_o_r_t_e_r_N_a_m_e_s(_o_b_j_e_c_t)', '_r_e_p_o_r_t_e_r_N_a_m_e_s(_o_b_j_e_c_t) <-          _v_a_l_u_e': 
          DEPRECATED, see 'featureNames'

     Standard generic methods:

     '_i_n_i_t_i_a_l_i_z_e(_o_b_j_e_c_t)': Object instantiation, can be called by
          derived classes but not usually by the user.

     '_v_a_l_i_d_O_b_j_e_c_t(_o_b_j_e_c_t)': 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

     '_a_s(_e_S_e_t, "_E_x_p_r_e_s_s_i_o_n_S_e_t")' Convert instance of class '"eSet"' to
          instance of 'ExpressionSet-class', if possible.

     '_a_s(_e_S_e_t, "_M_u_l_t_i_S_e_t")' Convert instance of class '"eSet"' to
          instance of 'MultiSet-class', if possible.

     '_u_p_d_a_t_e_O_b_j_e_c_t(_o_b_j_e_c_t, ..., _v_e_r_b_o_s_e=_F_A_L_S_E)' Update instance to
          current version, if necessary. Usually called through class
          inheritance rather than directly by the user. See
          'updateObject'

     '_u_p_d_a_t_e_O_b_j_e_c_t_T_o(_o_b_j_e_c_t, _t_e_m_p_l_a_t_e, ..., _v_e_r_b_o_s_e=_F_A_L_S_E)' Update
          instance to current version by updating slots in 'template',
          if necessary. Usually call by class inheritance, rather than
          directly by the user. See 'updateObjectTo'

     '_i_s_C_u_r_r_e_n_t(_o_b_j_e_c_t)' Determine whether version of object is
          current. See 'isCurrent'

     '_i_s_V_e_r_s_i_o_n_e_d(_o_b_j_e_c_t)' Determine whether object contains a
          'version' string describing its structure . See 'isVersioned'

     '_s_h_o_w(_o_b_j_e_c_t)' Informatively display object contents.

     '_d_i_m(_o_b_j_e_c_t)', '_n_c_o_l' Access the common dimensions ('dim') or
          column numbers ('ncol'), of all memebers ('dims') of
          'assayData'.

     '_o_b_j_e_c_t[(_i_n_d_e_x)': Conducts subsetting of matrices and phenoData
          components 

     '_o_b_j_e_c_t$_n_a_m_e', '_o_b_j_e_c_t$_n_a_m_e<-_v_a_l_u_e' Access and set 'name' column
          in 'phenoData'

     '_o_b_j_e_c_t[[_i]]', '_o_b_j_e_c_t[[_i]]<-_v_a_l_u_e' Access and set column 'i'
          (character or numeric index) in 'phenoData'

     Additional functions:

     _a_s_s_a_y_D_a_t_a_E_l_e_m_e_n_t(_o_b_j_e_c_t, _e_l_e_m_e_n_t) Return matrix 'element' from
          'assayData' slot of 'object'.

     _a_s_s_a_y_D_a_t_a_E_l_e_m_e_n_t(_o_b_j_e_c_t, _e_l_e_m_e_n_t) <- _v_a_l_u_e) Set element 'element'
          in 'assayData' slot of 'object' to matrix 'value'

     _a_s_s_a_y_D_a_t_a_E_l_e_m_e_n_t_R_e_p_l_a_c_e(_o_b_j_e_c_t, _e_l_e_m_e_n_t, _v_a_l_u_e) Set element
          'element' in 'assayData' slot of 'object' to matrix 'value'

     _a_s_s_a_y_D_a_t_a_E_l_e_m_e_n_t_N_a_m_e_s(_o_b_j_e_c_t) Return element names in 'assayData'
          slot of 'object'

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

_A_u_t_h_o_r(_s):

     Biocore team

_S_e_e _A_l_s_o:

     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'.

_E_x_a_m_p_l_e_s:

     # 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"))

     removeClass("MySet")
     removeClass("TwoColorSet")
     removeMethod("initialize", "TwoColorSet")

