findGenomicEvents          package:snapCGH          R Documentation

_F_i_n_d_s _t_h_e _g_e_n_o_m_i_c _e_v_e_n_t_s _a_s_s_o_c_i_a_t_e_d _w_i_t_h _e_a_c_h _o_f _t_h_e _a_r_r_a_y _C_G_H _s_a_m_p_l_e_s

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

     Finds the genomic events associated with each of the array CGH
     samples. Events include whole chromosomal gains and losses,
     aberrations, transitions, amplifications and their respective
     counts and sizes. The hmm states has to be computed before using
     this function.

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

     findGenomicEvents(segList, maxChrom = 22, factor = 5, maxClones = 1,
                         maxLen = 1000, absValSingle = 1, absValRegion = 1,
                         diffVal1 = 1, diffVal2 = 0.5, maxSize = 10000,
                         pChrom.min = 0.9, medChrom.min = 0.1,
                         maxmadUse = 0.2, maxmedUse = 0.2, 
                         maxState = 3, maxStateChange = 10, minClone = 5)

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

 segList: Object of class 'SegList'. 

maxChrom: Highest chromosomal number to find events.

  factor: Determines outliers. See 'findOutliers'.

maxClones: Determines aberrations. See 'findAberrations'.

  maxLen: Determines aberrations. See 'findAberrations'.

absValSingle: Determines amplifications. See 'findAmplifications'.

absValRegion: Determines amplifications. See 'findAmplifications'.

diffVal1: Determines amplifications. See 'findAmplifications'.

diffVal2: Determines amplifications. See 'findAmplifications'.

 maxSize: Determines amplifications. See 'findAmplifications'.

pChrom.min: Determines whole chromosomal gains and losses. Chromosome
          should contain no transitions, have its absolute median equal
          or greater than 'medChrom.min' and at least 'medChrom.min'
          has to be greater or less than 0. 

medChrom.min: Determines whole chromosomal gains and losses. Chromosome
          should contain no transitions, have its absolute median equal
          or greater than 'medChrom.min' and at least 'medChrom.min'
          has to be greater or less than 0. 

maxmadUse: See: 'computeSD'

maxmedUse: See: 'computeSD'

maxState: See: 'computeSD'

maxStateChange: See: 'computeSD'

minClone: See: 'computeSD'

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

     The default parameters generally work. Threshold for merging may
     be changed depending on the expected normal cell contamination
     and/or expected magnitude of the changes. AIC model generally
     works, however, may need to be readjusted depending on how liberal
     or conservative one wants to be in finding genomic events. We
     recommend BIC criterion with delta = 1 for noisier data.

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

num.transitions: matrix of dimensions maxChrom by number of samples. It
          contains number of transitions that were recorded on a given
          chromosome for a given sample. 

num.amplifications: matrix of dimensions maxChrom by number of samples
          It contains number of amplifications that were recorded on a
          given chromosome for a given sample. 

num.aberrations: matrix of dimensions maxChrom by number of samples. It
          contains number of focal aberrations that were recorded on a
          given chromosome for a given sample. 

num.outliers: matrix of dimensions maxChrom by number of samples.  It
          contains number of outliers that were recorded on a given
          chromosome for a given sample. 

num.transitions.binary: binary matrix of dimensions maxChrom by number
          of samples. Non-zero entry indicates whether 1 or more
          transitions were recorded on a given chromosome for a given
          sample. 

num.amplifications.binary: binary matrix of dimensions maxChrom by
          number of samples. Non-zero entry indicates whether 1 or more
          amplifications were recorded on a given chromosome for a
          given sample. 

num.aberrations.binary: binary matrix of dimensions maxChrom by number
          of samples. Non-zero entry indicates whether 1 or more focal
          aberrations were recorded on a given chromosome for a given
          sample. 

num.outliers.binary: binary matrix of dimensions maxChrom by number of
          samples. Non-zero entry indicates whether 1 or more outliers
          were recorded on a given chromosome for a given sample. 

whole.chrom.gain.loss: matrix of dimensions maxChrom by number of
          samples. Positive entry indicates that a given chromosome was
          gained in a given sample, negative entry indicates that a
          given chromosome was lost in a given sample, 0 entry is
          normal chromosome and NA marks chromosomes with one or more
          transition. 

size.amplicons: matrix of dimensions maxChrom by number of samples.
          Reports size of a given chromosome that is amplified (kb
          units) in a given sample. 

num.amplicons: matrix of dimensions maxChrom by number of samples.
          Reports number of disjoint amplicons on a given chromosome
          for a given sample. 

outliers: list containing 3 matrices of dimensions number of clones by
          number of samples. See 'findOutliers'. 

aberrations: list containing a matrix of dimensions number of clones by
          number of samples. See 'findAberrations'. 

transitions: list containing 2 matrices of dimensions number of clones
          by number of samples. See 'findTranslocations'. 

amplifications: list containing a matrix of dimensions number of clones
          by number of samples. See 'findAmplifications'. 

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

     'runHomHMM' 'mergeStates' 'findAberrations' 'findTranslocations'
     'findAmplifications' 'findOutliers'

