breakpoints.ProbBin         package:rflowcyt         R Documentation

_O_b_t_a_i_n _b_r_e_a_k _p_o_i_n_t_s _f_o_r _P_r_o_b_a_b_i_l_i_t_y _b_i_n_n_i_n_g

_D_e_s_c_r_i_p_t_i_o_n:

     To define the break points in data.var in which there are N
     observations in each bin.

_U_s_a_g_e:

     breakpoints.ProbBin(data.var, N)

_A_r_g_u_m_e_n_t_s:

data.var: a vector of numeric data values for the break points to be
          determined 

       N: the number of data points between two breaks 

_D_e_t_a_i_l_s:

     This function is used to determine the break points that can be
     used to specify a 'ProbBin.FCS' object as well as a 'hist' object.

     Please note that each bin in the histograms (in 'ProbBin.FCS')
     will be determined such that the end point is included (ie, for
     a<b, (a,b] is the bin interval for break points a & b.

     Thus, the output of this function will have min(data.var)-1 as the
     first break point and max(data.var) as the last break point such
     that (min(data.var)-1, min(data.var)] is the first bin/interval of
     the break points.

_V_a_l_u_e:

     a vector of the numerical breaks

_A_u_t_h_o_r(_s):

     Zoe Moodie, A.J. Rossini, J.Y. Wan

_R_e_f_e_r_e_n_c_e_s:

     Mario Roederer, et al. "Probability Binning Comparison: A Metric
     for Quantitating Univariate Distribution Differences" Cytometry
     45:37-46 (2001).

_S_e_e _A_l_s_o:

     'ProbBin.FCS' 'hist'

_E_x_a_m_p_l_e_s:

       x <- 1:23
       N <- 3

     ## making a series of cutpoints which have
     ## an equal number of counts in each bin 
       breaks <- breakpoints.ProbBin(x, N)

       hist(x, br=breaks, plot=FALSE)

