NetAffxResource-class     package:AffyCompatible     R Documentation

_M_a_n_a_g_e _N_e_t_A_f_f_x _a_n_n_o_t_a_t_i_o_n_s

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

     This class is for accessing and retrieving NetAffx annotation
     files for Affymetrix chips. It requires that the user has
     established an account with Affymetrix. Detailed usage is
     described in the `Annotations with NetAffx' vignette.

_O_b_j_e_c_t_s _f_r_o_m _t_h_e _C_l_a_s_s:

     Objects are created by calls of the form
     'NetAffxResource(user="user@research.org", password="terces")', as
     illustrated below and in the `Annotations with NetAffx vignette.

_S_l_o_t_s:


     '_u_s_e_r': Object of class '"character"' containing the full user
          name (typically an email address) obtained when the user
          registers with Affymetrix.

     '_p_a_s_s_w_o_r_d': Object of class '"character"' containing the password
          associated with the Affymetrix user name. The password is
          entered and stored in plain text, and should not be
          considered secure within Bioconductor.

     '_a_f_f_x_L_i_c_e_n_c_e': Object of class '"character"' containing the
          licence, obtained from Affymetrix, for retrieving NetAffx
          annotations. The licence is usually software specific (e.g.,
          for the AffyCompatible package of Bioconductor). Users will
          not usually change the defeault value.

     '_d_i_r_e_c_t_o_r_y': Object of class '"character"', containing the local
          directory path where the NetAffx data base and annotation
          files will reside.

     '_a_n_n_o_t_a_t_i_o_n_s_F_i_l_e': Object of class '"character"' containing the
          file name of the NetAffx data base. Users will not usually
          change the default value.

     '_a_f_f_x_U_r_l': Object of class '"character"' containing the URL used
          to download the NetAffx annotations file. Users will not
          usually change the default value.

_E_x_t_e_n_d_s:

     Class '"NetAffxCompatibility"', directly. Class
     '"AffyCompatible"', by class "NetAffxCompatibility", distance 2.

_M_e_t_h_o_d_s:


     [[ 'signature(x = "NetAffxResource", i = "numeric", j =
          "missing")'

     [[ 'signature(x = "NetAffxResource", i = "character", j =
          "missing")': Retrieve an object representing all NetAffx
          annotations available for an array. The argument 'i' may be a
          numeric index or character string corresponding to an array
          name returned by 'names(x)'.

     [[ 'signature(x = "NetAffxResource", i = "numeric", j =
          "numeric")'

     [[ 'signature(x = "NetAffxResource", i = "character", j =
          "numeric")'

     [[ 'signature(x = "NetAffxResource", i = "numeric", j =
          "character")'

     [[ 'signature(x = "NetAffxResource", i = "character", j =
          "character")': Retrieve an object representing a specific
          annotation for an array. The argument 'i' may be a numeric
          index or character string corresponding to an array name
          returned by 'names(x)'. The argument 'i' may be a numeric
          index or character string corresonding to an annotation
          returned by 'description(x[[i]])'.

     _a_f_f_x_L_i_c_e_n_c_e 'signature(x = "NetAffxResource")':  the character
          string representation of the licence used to access the
          NetAffx site.

     _a_f_f_x_U_r_l 'signature(x = "NetAffxResource")': the url used to access
          the NetAffx site.

     _a_n_n_o_t_a_t_i_o_n_s_F_i_l_e 'signature(x = "NetAffxResource")': the file name
          of NetAffx data base, as stored on the local disk of the
          user.

     _d_i_r_e_c_t_o_r_y 'signature(x = "NetAffxResource")': the directory in
          wich the NetAffx data base and annotation files are stored on
          the local disk of the user.

     _n_a_m_e_s 'signature(x = "NetAffxResource")': the names of the arrays
          for which annotations are available.

     _p_a_s_s_w_o_r_d 'signature(x = "NetAffxResource")': The password
          associated with the user name obtained when the user
          registered with Affymetrix. The password is entered and
          stored as plain text, and is not secure.

     _r_e_a_d_A_n_n_o_t_a_t_i_o_n 'signature(netAffxResource = "NetAffxResource",
          array = "numeric", annotation = "numeric", ...)'

     _r_e_a_d_A_n_n_o_t_a_t_i_o_n 'signature(netAffxResource = "NetAffxResource",
          array = "numeric", annotation = "character", ...)'

     _r_e_a_d_A_n_n_o_t_a_t_i_o_n 'signature(netAffxResource = "NetAffxResource",
          array = "character", annotation = "numeric", ...)'

     _r_e_a_d_A_n_n_o_t_a_t_i_o_n 'signature(netAffxResource = "NetAffxResource",
          array = "character", annotation = "character", ...)'

     _r_e_a_d_A_n_n_o_t_a_t_i_o_n 'signature(netAffxResource = "NetAffxResource",
          array = "missing", annotation = "AffxAnnotation", ...)': 
          Read a specific anntotation file as an R object. for the
          first four methods, 'array', if present, indexes or names the
          array while 'annotation' indexes or names the annotation. All
          methods also accept 'content = "logical"' to indicate whether
          the content of the file should be returned if possible
          ('content=TRUE', default) or only the path to the local file
          ('content=FALSE') and 'update = "logical"' indicating whether
          the file should be read from disk if available
          ('update=FALSE', default) or retrieved from the NetAffx web
          site ('update=TRUE'). 'readAnnotation' parses 'CSV, Tabular,
          PSI' to data frames, and reads 'FASTA' files to a list of
          description / sequence pairs (see 'Biostrings::readFASTA').

     _s_h_o_w 'signature(object = "NetAffxResource")': compactly show the
          'NetAffxResource' object.

     _u_s_e_r 'signature(x = "NetAffxResource")': The user name (typcially
          email address) obtained when the user registers with the
          Affymetrix web site.

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

     Martin Morgan <mtmorgan@fhcrc.org>

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

     Vignette `Annotations with NetAffx'. Affymetrix user login site
     <URL: https://www.affymetrix.com/site/login/login.affx>.

     '.Rprofile' for ways to automatically set variables (such as
     'password', and 'directory') for each session.

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

     ## password must be obtained by the user
     rsrc <- NetAffxResource(user="mtmorgan@fhcrc.org", password=password)
     head(names(rsrc))
     affxDescription(rsrc[["Bovine"]])
     ## paradigm to display all elements of 'annotation'
     sapply(affxAnnotation(rsrc[["Bovine"]]), force)
     ## obtain and read a single annotation
     anno <- rsrc[["Porcine", "BLASTP annotations, CSV Format"]]
     df <- readAnnotation(rsrc, annotation=anno)

