getSYMBOL              package:annotate              R Documentation

_F_u_n_c_t_i_o_n_s _t_o _d_e_a_l _w_i_t_h _D_a_t_a _P_a_c_k_a_g_e_s

_D_e_s_c_r_i_p_t_i_o_n:

     The functions documented here are intended to make it easier to
     map from a set of manufacturers identifiers (such as you will get
     from the chips etc) to other identifiers.

_U_s_a_g_e:

     getSYMBOL(x, data)
     getLL(x, data)
     getGO(x, data)
     getPMID(x, data)
     getGOdesc(x, which)
     lookUp(x, data, what, load = FALSE)
     getUniqAnnItem()

_A_r_g_u_m_e_n_t_s:

       x: The identifiers to be mapped (usually manufacturer)

    data: The basename of the meta-data package to be used. 

    what: 'what' a character string for the name of an annotation
          element of an annotation data package

   which: 'which' a character string in the form of MF, BP, CC, or ANY
          to indicated the GO categories of interest

    load: A logical value indicating whether to attempt to load the
          required annotation data package if it isn't already loaded.

_D_e_t_a_i_l_s:

     Users must supply the basename of the meta-data package that they
     want to use to provide the mappings. The name of the meta-data
     package is the same as the basename.

     Appropriate translations are done. In some cases such as 'getLL'
     and 'getSYMBOL' there will only be one match and a vector is
     returned. In other cases such as 'getPMID' and 'getGO' there may
     be multiple matches and a list is returned.

     For 'getGOdesc' 'x' contains GO identifiers (not manufacturer
     identifiers) and the output is a list of GOTerms objects, if
     'which' specifies some subset of the ontologies (MF, BP or CC) 
     then only terms for that ontology are retained.

     'lookUp' is a general function that can be used to look up
     matches. All other translation functions use 'lookUp'

     A BioC annotation data package contains annotation data
     environments whose names are package name (e. g. hgu95av2) +
     element name (e. g. PMID). 'what' must be one of the element names
     for the given data package. 

     'getUniqAnnItem' keeps track of the annotation elements that have
     one to one mappings.

_V_a_l_u_e:

     Either a vector or a list depending on whether multiple values per
     input are possible.

_A_u_t_h_o_r(_s):

     R. Gentleman

_S_e_e _A_l_s_o:

     'mget'

_E_x_a_m_p_l_e_s:

       data(sample.ExpressionSet)
       gN <- featureNames(sample.ExpressionSet)[100:105]
        ## A bit of a hack to not have a package dependency on hgu95av2
        ## but need to fiddle w/ the warn level to not fail the example
        ## anyways.
        have_hgu95av2 <- suppressWarnings(require("hgu95av2"))
        have_GO <- suppressWarnings(require("GO"))
        if (have_hgu95av2 && have_GO) {
           lookUp(gN, "hgu95av2", "SYMBOL")
           # Same as lookUp for SYMBOL except the return is a vector
           getSYMBOL(gN,"hgu95av2" )
           gg <- getGO(gN, "hgu95av2")
           lookUp(gg[[2]][[1]][["GOID"]], "GO", "TERM")
           # Same as lookUp for TERM
           getGOdesc(gg[[2]][[1]][["GOID"]], "ANY")
           # For BP only
           getGOdesc(gg[[2]][[1]][["GOID"]], "BP")
           getLL(gN, "hgu95av2")
           getPMID(gN, "hgu95av2")
        } else {
          cat("could not run all examples\n")
        }

