extractGateHistory         package:rflowcyt         R Documentation

_E_x_t_r_a_c_t_i_n_g _t_h_e _g_a_t_i_n_g _i_n_f_o_r_m_a_t_i_o_n _f_r_o_m _t_h_e _h_i_s_t_o_r_y

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

     The history string corresponding to a specific gating Index
     specified by 'gateNum' is retrieved and output as a list of
     specific components.

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

     extractGateHistory(x, gateNum)

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

       x: a "FCSgate" object created after using 'createGate'

 gateNum: the numeric column position of the gating index in the 'gate'
          matrix 

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

 gateNum: the numeric column position of the gating index in the 'gate'
          matrix

gateName: character name of the gating index specified in the 'gate'
          matrix

    type: type of gating (ie, "biscut", "uniscut", "bipcut", "bidcut")

biscut.quadrant: the quadrant specified (ie, ("+/+", "-/-", "+/-",
          "-/+"))

data.colpos: the gated parameter column positions in the 'data' matrix

data.colnames: the gated parameter column names in the 'data' matrix

IndexValue.In: the value of the index that specifies inclusion or
          selection

gatingrange: the vector of gating threshold(s)

prev.gateNum: the previous or most prior gating index column position
          in the 'gate' matrix

prev.gateName: the previous or most prior gating index column name in
          the 'gate' matrix

 comment: character string of the user-defined comment

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

     A.J. Rossini and J.Y. Wan

_R_e_f_e_r_e_n_c_e_s:

     Trevor Hastie, Robert Tibshirani, and Jerome Friedman. The
     Elements of Statistical Learning: Data Mining, Inference, and
     Prediction. Springer Series in Statistics : New York, 2001.
     pp.279-283.

     Jerome H. Friedman and Nicholas I. Fisher. Bump Hunting in
     High-Dimensional Data. Tech Report. October 28, 1998.

     J. Paul Robinson, et al. Current Protocols in Cytometry.  John
     Wiley & Sons, Inc : 2001.

     Mario Roederer and Richard R. Hardy. Frequency Difference Gating:
     A Multivariate Method for Identifying Subsets that Differe between
     Samples. Cytometry, 45:56-64, 2001.

     Mario Roederer and Adam Treister and Wayne Moore and Leonore A.
     Herzenberg. Probability Binning Comparison: A Metric for
     Quantitating Univariate Distribution Differences. Cytometry,
     45:37-46, 2001.

     Keith A. Baggerly. Probability Binning and Testing Agreement
     between Multivariate Immunofluorescence Histograms: Extending the
     Chi-Squared Test. Cytometry, 45:141-150, 2001.

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

     'FCS-class', 'FCSgate-class', 'createGate,
     \code{extractGatedData}'

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

      if (require(rfcdmin)) {
           data.there<-is.element("MC.053",objects())
           if ((sum(data.there) != length(data.there))) {
             ## obtaining the FCS objects from VRC data
             data(MC.053min)
           }
       
     ####  foo1 : Gating type: uniscut, univariate single cut
     foo1 <- createGate(MC.053, varpos=4, gatingrange=256,
                         type="uniscut", MY.DEBUG=TRUE)

     #### foo2.3 : Gating type : biscut -/-
     foo2.3 <- createGate(foo1, varpos=c(1,2),
                           gatingrange=c(256, 300),
                           type="biscut",
                           biscut.quadrant="-/-",
                           prev.gateNum=NULL,
                           MY.DEBUG=TRUE)

     ## obtain gate information for first uniscut gate
     gate.info1<-extractGateHistory(foo1, gateNum=1)

     ## obtain gate information for the second biscut gate
     gate.info2<-extractGateHistory(foo2.3, gateNum=2)

     ### foo2.3.1 : extraction
     foo2.3.1 <- extractGatedData(foo2.3, gateNum=2,
                                   IndexValue.In=1,
                                   MY.DEBUG=TRUE)
     ## obtain the second biscut gate information after
     ## subset/extraction of row observations
     gate.info2.1<-extractGateHistory(foo2.3.1, gateNum=2)
     }

