pubmed               package:annotate               R Documentation

_A _f_u_n_c_t_i_o_n _t_o _o_p_e_n _t_h_e _b_r_o_w_s_e_r _t_o _P_u_b_m_e_d _w_i_t_h _t_h_e _s_e_l_e_c_t_e_d _g_e_n_e.

_D_e_s_c_r_i_p_t_i_o_n:

     Given a vector of Pubmed identifiers or accession numbers, the
     user can either have a browser display a URL showing a Pubmed
     query for those identifiers, or a XMLdoc object with the same
     data.

_U_s_a_g_e:

     pubmed(...,disp=c("data","browser"), type=c("uid","accession"),
            pmaddress=.pmfetch("PubMed", disp, type))

_A_r_g_u_m_e_n_t_s:

     ...: Vectorized set of Pubmed ID's

    disp: Either "Data" or "Browser" (default is data).  Data returns a
          XMLDoc, while Browser will display information in the user's
          browser.

    type: Denotes whether the arguments are accession numbers or UIDS. 
          Defaults to uids.

pmaddress: Specific path to the pubmed pmfetch engine from the NCBI
          website.

_D_e_t_a_i_l_s:

     A simple function to retrieve Pubmed data given a specific ID,
     either through XML or through a web browser.  This function will
     accept either pubmed accession numbers or NCBI UIDs (defined as a
     Pubmed ID or a Medline ID) - although the types must not be mixed
     in a single call. 

     WARNING:  The powers that be at NCBI have been known to ban the IP
     addresses of users who abuse their servers (currently defined as
     less then 2 seconds between queries).  Do NOT put this function in
     a type loop or you may find your access revoked.

_V_a_l_u_e:

     If the option "data" is used, an object of type XMLDoc is
     returned, unless there was an error with the query in which case
     an object of type try-error is returned.

     If the option "browser" is used, nothing is returned.

_A_u_t_h_o_r(_s):

     R. Gentleman

_S_e_e _A_l_s_o:

     'genbank', 'locuslinkByID', 'locuslinkQuery', 'xmlTreeParse'

_E_x_a_m_p_l_e_s:

        if( interactive() )
         opts <- c("data","browser") else
         opts <- "data"
        for (dp in opts)
          pubmed("11780146","11886385","11884611",disp=dp)

