tspsig                package:tspair                R Documentation

_S_i_g_n_i_f_i_c_a_n_c_e _c_a_l_c_u_l_a_t_i_o_n _f_o_r _t_o_p _s_c_o_r_i_n_g _p_a_i_r_s

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

     This function calculates the significance of a top-scoring pair.
     It can be run after tspcalc() to calculate how strong a TSP is.

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

       tspsig(dat,grp,B=50,seed=NULL)

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

     dat: Can take two values: (a) an m genes by n arrays matrix of
          expression data or (b) an eSet object

     grp: Can take one of two values: (a) A group indicator incharacter
          or numeric form, (b) an integer indicating the column of
          pData(dat) to use as the group indicator

       B: The number of permutations to perform in calculation of the
          p-value, default is 50.

    seed: If this is a numeric argument, the seed will be set for
          reproducible p-values.

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

     tspsig() only works for two group classification. The computation
     time grows rapidly in the number of  genes, so for large gene
     expression matrices one should be prepared to wait or do a
     pre-filtering step. A progress bar is shown which gives some
     indication of the time until the calculation is complete. The top
     scoring pairs methodology was originally described in Geman et al.
     (2004).

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

       p: A p-value for testing the null hypothesis that there is no
          TSP for the data set dat.

nullscores: The null TSP scores from the permutation test.

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

     Jeffrey T. Leek jtleek@jhu.edu

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

     D. Geman, C. d'Avignon, D. Naiman and R. Winslow, "Classifying
     gene expression profiles from pairwise mRNA comparisons," 
     Statist. Appl. in Genetics and Molecular Biology, 3, 2004.

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

     'tspplot', 'ts.pair', 'tspcalc','predict.tsp', 'summary.tsp'

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

       ## Not run: 
       ## Load data
       data(tspdata) 

       ## Run tspcalc() on a data matrix and grp vector
       tsp1 <- tspcalc(dat,grp)

       ## Run tspsig() to get a p-value
       p <- tspsig(dat,grp)
       p
      ## End(Not run)

