proBin               package:flowStats               R Documentation

_P_r_o_b_a_b_i_l_i_t_y _b_i_n_n_i_n_g - _a _m_e_t_r_i_c _f_o_r _e_v_a_l_u_a_t_i_n_g _m_u_l_t_i_v_a_r_i_a_t_e _d_i_f_f_e_r_e_n_c_e_s

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

     This function divides the flowframe events into bins such that
     each bin contains the same number of events. The number of events
     falling into each bin can then be compared across the control and
     test samples using statistical methods such as the Chi-squared
     test.

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

     proBin(m, minEvents)

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

       m: An object of class 'flowFrame'

minEvents: The 'minEvents' The minimum number of events in each bin.
          (i.e. the termination criterion for the probability binning
          algorithm)

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

     The 'flowSet' is first filtered using a 'rectangleGate' and the
     'norm2Filter' is subsequently fitted to the remaining subset.

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

     A list with items:

  table : A 'data.frame' that stores information regarding each node of
          the tree generated during each stage of the probability
          binning algorithm.  Each row in the table represents a node,
          the first row representing the original 'flowFrame' matrix.

          The dataIndx column provides indexes for retrieving the
          matrices during each stage of the binning process from the
          enviroment 'data' .

          The parent field indicates the row number in the table that
          holds the parent information for the corresponding node.

          The left and right columns indicates the row numbers in the
          table that stores information regarding the children of that
          particular node. The leaf nodes that hold the binned data can
          be identified by the nodes with the left of right values of
          zero( ie. no children nodes)

          The visited column is used internally by the algorithm to
          check if a particular node has been visited during the
          computation process.

   data : An enviroment in which the matrices generated during each
          stage of the probability binning process is stored. The
          matrices stored at the leaf nodes represent the binned events
          obtained after the stop criterion of minEvents has been
          achieved. These can be identified by the corresponding
          dataIndx fields provided by the rows in the table with the
          left or right column values of zero.  

 limits : A list containing the the boundaries of each hyperplane
          generated during probability binning

splitPars : A 'data.frame' containing two columns splitCol - indicates
          the column number of the 'flowFrame' , the split was
          performed.

          splitMed - The median value which was used as the threshold
          for splitting the 'flowFrame'

          The splitCol and splitMed parameters are utilized by the
          plotBins and shadeBins functions in visualizing the
          differences between control and test sample cases.

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

     Nishant Gopalakrishnan

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

     'plotBins', 'binByRef'

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

     data(GvHD)
     res<-proBin(GvHD[[1]],200) 

