"checkvars-methods"         package:rflowcyt         R Documentation

_C_h_e_c_k_s _t_h_e _r_a_n_g_e_s, _d_i_m_e_n_s_i_o_n_s, _a_n_d _n_a_m_e_s _o_f _t_h_e _m_e_t_a_d_a_t_a _b_a_s_e_d _o_n _t_h_e
_c_u_r_r_e_n_t _d_a_t_a _o_f _a_n _F_C_S _R-_o_b_j_e_c_t.

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

     Any discrepancy between the metadata and the data of the FCS
     object is considered as a failure to pass the check.  The
     following is a description of the checks:

_1. _D_i_m_e_n_s_i_o_n _c_h_e_c_k We always check the dimensions (ie, if the data
     dimensions match with size ("$TOT") and nparam ("$PAR") that are
     specified in the metadata).   

_2. _P_a_r_a_m_e_t_e_r _N_a_m_e _c_h_e_c_k We check the names of the metadata with the
     names of the data column parameters.  Either only the longnames
     ("$PnS") or the shortnames ("$PnN") of the metadata are checked
     against the names of the data.  Please take note that both
     ("$PnS") and ("$PnN") ARE NOT BOTH checked. 

_3. _C_o_l_u_m_n _V_a_r_i_a_b_l_e _R_a_n_g_e _C_h_e_c_k We check the paramranges ("$PnR")
     specified in the metadata with the column parameter ranges of the
     data; if the paramranges do not exist in the metadata, then it is
     noted in the debugging statements.

     Please note that if the metadata@original is FALSE, then the
     metadata slotNames have a  "RFACSadd$>>$" suffix and are located
     in metadata@fcsinfo in order to store the current data
     descriptives. The original data descriptives can be
     retrieved/checked when metadata@original is set to TRUE; otherwise
     the current metadata information about the data is
     retrieved/checked even when the "RFACSadd$>>$" suffix is not noted
     in the character index.

     (ie) If metadata@original is FALSE, then metadata[["size"]] will
     return metadata[["RFACSadd$>>$$TOT"]], the current row length of
     the data, while metadata@size will return the number of rows for
     the original data.

     Note that metadata@original is changed only when a parameter
     column is added to the data using 'addParameter-methods', when
     rows of the data are extracted using 'extractGatedData' or if the
     user decides to change the value metadata@original.  Using
     '"["-methods' and '"[<-"-methods' on a "FCS" object will not
     change the value of metadata@original.

_M_e_t_h_o_d_s:


     _x = "_F_C_S" boolean value is returned; TRUE if the check passes and
          FALSE if it does not pass the check.

     _x = "_F_C_S", _M_Y._D_E_B_U_G=_T_R_U_E, _r_a_n_g_e._m_a_x=_N_U_L_L Other options in the
          signature include:

          (1) MY.DEBUG : boolean value; if TRUE, then the output
          statements are printed, otherwise if FALSE, then the
          statements are surpressed; default is TRUE.

          (2) range.max : numeric value describing the true maximum of
          the data that the checks on the ranges will be compared;
          default is NULL (ie, the maximum of each column variable in
          the data is the truth)

