createFlowReport         package:flowFlowJo         R Documentation

_P_r_o_d_u_c_e _a _d_e_n_o_r_m_a_l_i_z_e_d _d_a_t_a _f_r_a_m_e _o_f _s_u_m_m_a_r_y _s_t_a_t_i_s_t_i_c_s _a_n_d _o_t_h_e_r _i_n_f_o_r_m_a_t_i_o_n _o_n _a _s_e_t _o_f _F_l_o_w_J_o _g_a_t_e_d _F_C_S _f_i_l_e_s

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

     This method produces a data frame that has one row per cell
     population per FCS file per channel for one or more FCS files as
     gated using the commercial software, FlowJo.

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

     createFlowReport(summaryList, ...)

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

summaryList: a flowFlowJo object that is a list of data structures
          providing many bits of summary information about each gated
          population in a gated FCS file.  See also
          _collectSummaryFlowInfo_ 

     ...: Additional factors detailed below.

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

     Additional arguments also include the following:  


         factorsFrame    - an additional data frame with various types
     of meta data related to the experiment in question 
         populations     - a list of cell population names to be
     reported on.  By default, the summary statistics on all the cell
     populations will be reported. 
         channels        - a list of scatter and non-scatter
     (fluorescent) channels to be reported on.  By default, the summary
     statistics for all channels will be reported. 
         includeKeywords - a boolean with the default = TRUE.  If
     FALSE, then none of the keywords from the headers of the FCS files
     that were harvested in an earlier step will be reported. 
         joinFactors     - if the user supplies an optional data frame
     with additional meta data about the experiment, these columns in
     the data frame will be used to match up items in the data frame
     with the correct FCS files. The default is
     joinFactors=c("FCSFilename", "FlowJoWorkspace")
         dropJoinFactors - a boolean with default = TRUE.  If set to
     FALSE, then the name (and path) of the FCS file and the FlowJo
     workspace will be included in every  line of the report.  That
     would make the report very ugly to read.   


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

     The _collectSummaryFlowInfo_ method produces a large and
     complicated data structure that tracks every FCS file location,
     gate structure, compensation matrix, as well as the summary
     statistics for every file referenced in a FlowJo workspace.  This
     method, _createFlowReport_ distills out a simple data frame of the
     summary statistics that is convenient and easy to read, plot, and
     otherwise analyze.

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

     John Gosink

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

     library(flowFlowJo);
     demoLocation <- system.file("extdata", "DemoWorkspace.wsp", package="flowFlowJo"); 
     actualFCSLoc <- system.file("extdata/fcsFiles", package="flowFlowJo"); 
     testList     <- readFlowJoList(demoLocation, altFileLocation=actualFCSLoc);

     # This next statement may take a few moments to run as it is parsing through a FlowJo workspace
     # and two dozen FCS files...
     summaryStatsObj <- collectSummaryFlowInfo(testList);

     # And here are some of the summary statistics for this workspace
     flowReport      <- createFlowReport(summaryStatsObj);
     head(flowReport);

