degreeEstimates           package:ppiStats           R Documentation

_E_s_t_i_m_a_t_e _p_e_r-_n_o_d_e _d_e_g_r_e_e _i_n _v_i_a_b_l_e _b_a_i_t-_p_r_e_y (_V_B_P) _g_r_a_p_h _u_s_i_n_g _m_a_x_i_m_u_m
_l_i_k_e_l_i_h_o_o_d.

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

     Estimate per-node degree in viable bait-prey (VBP) graph using
     maximum likelihood.

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

     degreeEstimates(m,pTP,pFP)
     findDegree(rd,ud,pTP,pFP,N)
     degreePMF(deltahat,rd,ud,pTP,pFP,N)

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

       m: Square incidence matrix for VBP graph.

     pTP: True positive probability.

     pFP: False positive probability.

      rd: Observed number of reciprocated edges.

      ud: Observed number of unreciprocated edges.

deltahat: Estimate of node degree.

       N: Number of proteins which were tested twice (e.g. both as
          viable bait and as viable prey.)  Should equal the number of
          rows of m.

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

     'degreeEstimates' returns per-node degree estimates using the
     maximum likelihood method of Scholtens et al. (Submitted).  It
     takes arguments 'm', which is an incidence matrix of bait-prey
     relationships, typically a VBP graph filtered for proteins prone
     to systematic bias, as well as pTP and pFP values, globally
     applicable to the entire graph.

     'degreeEstimates' calls the function 'findDegree' which estimates
     degree for a single node, given its observed number of
     reciprocated and unreciprocated incident edges.  'findDegree'
     takes an argument 'N' which is the number of proteins in the graph
     that were tested twice.  When 'degreeEstimates' calls
     'findDegree', 'N' is set to the first dimension of the incidence
     matrix 'm'.  

     'degreePMF' calculates the value of the pmf for an estimated
     degree, given observed numbers of reciprocated and unreciprocated
     edges, as well as pTP, pFP, and N.  It is not generally called
     directly by the user.  It is used to locate the maximum likelihood
     estimator for degree.

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

     'degreeEstimates' returns a named vector of degree estimates for
     each node in the graph.

     'findDegree' returns a single degree estimate for one node.

     'degreePMF' returns the value of the pmf for the multinomial model
     at a specified estimate of node degree, given the number of
     observed reciprocated and unreciprocated edges incident on the
     node and pTP and pFP.

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

     Denise Scholtens, dscholtens@northwestern.edu

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

     Scholtens D, Chiang T, Huber W, Gentleman R.  Estimating node
     degree in bait-prey graphs. (Submitted).

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

     findDegree(rd=2,ud=2,pTP=0.75,pFP=0.001,N=1000)

