summarizeReplicates         package:cellHTS         R Documentation

_S_u_m_m_a_r_i_z_e_s _b_e_t_w_e_e_n _n_o_r_m_a_l_i_z_e_d _r_e_p_l_i_c_a_t_e _v_a_l_u_e_s _g_i_v_e_n _i_n _a _c_e_l_l_H_T_S _o_b_j_e_c_t, _o_b_t_a_i_n_i_n_g _a _s_i_n_g_l_e _z-_s_c_o_r_e _f_o_r _e_a_c_h _p_r_o_b_e

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

     Summarizes the normalized (and possibly already scored) replicate
     values given in a cellHTS object, and calculates a single z-score
     value for each probe.

     Currently this function is implemented only for single-color data.

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

     summarizeReplicates(x, zscore, summary="min")

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

       x: a cellHTS object that has already been normalized (see
          details).

  zscore: indicates if the replicate values should be centered and
          scaled.  If missing (default), the data will not be centered
          and scaled. Otherwise, the value of this argument should be a
          character string, either "+" or "-", specifying the sign to
          use for the calculated  z-scores (see details).

 summary: a character string indicating how to summarize between
          replicated measurements.  One of "min" (default), "mean", or
          "min" can be used (see details).

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

     Given the normalized values given in the slot 'xnorm' of 'x', a
     single z-score is calculated for each probe.

     The argument 'zscore' indicates the state of the normalized
     replicate measurements: if 'zscore' is missing, it is assumed that
     the replicates have been scored, by calling 'normalizePlateMedian'
      with the argument 'zscore' equal to "-" or "+"; Otherwise,
     'zscore' should be given, so that a robust z-score  is calculated
     for each plate and each well by subtracting the overall median and
     dividing by the overall mad. The overall median and mad are taken
     by considering the distribution of intensities (over all plates)
     in the wells whose content is annotated as 'sample'.  The allowed
     values for 'zscore' ("+" or "-") are used to set the sign of  the
     calculated z-scores. For example, with a 'zscore="-"' a strong
     decrease in the signal will be represented  by a positive z-score,
     whereas setting 'zscore="+"',  such a phenotype will be
     represented by a negative z-score.   This option can be set to
     calculate the results to the commonly used convention.

     Finally, a single z-score per probe is calculated by summarizing
     between scored replicates. If 'summary' is 'mean',  the average of
     replicate values is considered; if it is set to 'max', then the
     maximum of replicate intensities is taken, while if its value is
     set to 'min', the minimum is considered, instead (conservative).

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

     An object of class 'cellHTS', which is a copy of the argument 'x'
     plus the slot 'score', a numeric vector containing the z-factor
     for each well in every plate. The length of this vector is
     therefore equal to the product between the plateSize and the
     number of plates. Moreover, the processing status of the 'cellHTS'
     object is updated in the slot 'state' to 'state["scored"]= TRUE'.

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

     W. Huber huber@ebi.ac.uk, Ligia Braz ligia@ebi.ac.uk

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

     ..

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

      datadir = system.file("KcViabSmall", package = "cellHTS")
      x = readPlateData("Platelist.txt", "KcViabSmall", path=datadir)
      confFile = system.file("KcViabSmall", "Plateconf.txt", package="cellHTS")
      logFile  = system.file("KcViabSmall", "Screenlog.txt", package="cellHTS")
      descripFile  = system.file("KcViabSmall", "DESCRIPTION.txt", package="cellHTS")
      x = configure(x, confFile, logFile, descripFile)
      x = normalizePlateMedian(x)
      x = summarizeReplicates(x, zscore="-", summary="min")

