getGene               package:biomaRt               R Documentation

_R_e_t_r_i_e_v_e_s _g_e_n_e _a_n_n_o_t_a_t_i_o_n _i_n_f_o_r_m_a_t_i_o_n _g_i_v_e_n _a _v_e_c_t_o_r _o_f _i_d_e_n_t_i_f_i_e_r_s

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

     This function retrieves gene annotations from Ensembl given a
     vector of identifiers.  Annotation includes chromsome name, band,
     start position, end position, gene description and gene symbol.  A
     wide variety of identifiers is available in Ensembl, these can be
     found with the listFilters function.

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

     getGene( id, type, mart)

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

      id: vector of gene identifiers one wants to annotate

    type: type of identifier, possible values can be obtained by the
          listFilters function.  Examples are  entrezgene, hgnc_symbol
          (for hugo gene symbol), ensembl_gene_id, unigene,
          agilentprobe, affy_hg_u133_plus_2,  refseq_dna, etc.

    mart: object of class Mart, containing connections to the BioMart
          databases.  You can create such an object using the function
          useMart.

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

     Steffen Durinck, http://www.stat.berkeley.edu/~steffen

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

     if(interactive()){

     mart = useMart("ensembl", dataset="hsapiens_gene_ensembl")

     #example using affy id

     g = getGene( id = "1939_at", type = "affy_hg_u95av2", mart = mart)
     show(g)

     #example using Entrez Gene id

     g = getGene( id = "100", type = "entrezgene", mart = mart)
     show(g)
     }

