plotExpressionGraph       package:geneplotter       R Documentation

_A _f_u_n_c_t_i_o_n _t_o _p_l_o_t _a _g_r_a_p_h _c_o_l_o_r_e_d _b_y _e_x_p_r_e_s_s_i_o_n _d_a_t_a

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

     Given a graph and expression data for one entity, will plot the
     graph with the nodes colored according to the expression levels
     provided.

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

     plotExpressionGraph(graph, nodeEGmap, exprs, ENTREZIDenvir, mapFun, log = FALSE, nodeAttrs = list(), ...)

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

   graph: The graph to plot

nodeEGmap: A list with element names being node names and the elements
          being EntrezLink IDs corresponding to those node names.

   exprs: A vector of expression data, with names being Affymetrix IDs
          and values being the expression level.

ENTREZIDenvir: An environment mapping Affymetrix IDs to EntrezLink IDs,
          such as the ones provided in the xxx2ENTREZID environments
          from the Bioconductor data packages (where xxx) is a data
          package)

  mapFun: A function to map expression levels to colors

     log: Whether or not the expression data 

nodeAttrs: A list of node attributes, as per 'plot.graph'

     ...: Any extra arguments to be passed to 'plot.graph' 

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

     This function can be used to plot a graph and have the nodes
     colored according to expression levels provided by the user.  The
     'graph' parameter is a 'graph' object from the 'graph' package.

     The 'nodeEGmap' parameter is a list that maps the nodes of the
     graphs to EntrezLink IDs.  An example of this is the
     'IMCAEntrezLink' object in the 'integrinMediatedCellAdhesion' data
     set in the 'graph' package.

     The 'exprs' argument is a vector mapping expression levels to
     Affymetrix IDs.  One way to generate an appropriate vector is to
     extract a single column from an 'exprSet'.

     The 'ENTREZIDenvir' environment maps Affymetrix IDs to EntrezLink
     IDs.  The simplest way to provide this argument is to load the
     preferred Bioconductor data package (e.g. 'hgu95av2') and pass in
     that package's 'xxx2ENTREZID', where 'xxx' is the name of the
     package.

     The 'mapFun' function defaults to the function 'defMapFun', which
     maps nodes to be either blue, green or red depending for
     expression ranges of 0-100, 101-500, and 501+.  In the case where
     'log' is 'TRUE' these ranges are modified with 'log2'.  Custom
     versions of this function can be supplied by the user - it must
     take two parameters, first the expression vector and a boolean
     value ('log') specifying if the data has had a 'log2' applied to
     it.  The function must return a vector with the same names as the
     expression vector, but the values of the vector will be color
     strings.

     The 'nodeAttrs' list can be specified if any other node attributes
     are desired to be set by the user.  Please see the 'plot.graph'
     man page for more information on this.  The other attribute list
     ('attrs' and 'edgeAttrs') can be passed in via the '...'
     parameter.

     The IMCAEntrezLink data structure was created for the purpose of
     illustrating this program.  On Sept 24 2007, the current versions
     of  hgu95av2.db and hgu95av2 were used to map from the nodes of
     IMCAGraph (in graph package) to Entrez identifiers.

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

     Jeff Gentry

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

     'plot.graph', 'integrinMediatedCellAdhesion'

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

        if ((require("Rgraphviz")) && (require("hgu95av2")) &&
             (require("fibroEset")) && (interactive())) {     
                 data(integrinMediatedCellAdhesion)
                 data(IMCAEntrezLink)
                 data(fibroEset)
                 attrs=getDefaultAttrs()
                 attrs$graph$rankdir <- "LR"
                 plotExpressionGraph(IMCAGraph, IMCAEntrezLink,
                                     exprs(fibroEset)[,1],
                                     hgu95av2ENTREZID, attrs=attrs)
        }

