Phi                  package:Malmig                  R Documentation

_C_a_l_c_u_l_a_t_e_s _a _k_i_n_s_h_i_p _m_a_t_r_i_x _u_s_i_n_g _t_h_e _M_a_l_e_c_o_t _M_i_g_r_a_t_i_o_n _M_o_d_e_l

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

     Calculates a kinship matrix using the Malecot Migration Model, in
     the form described by L. B. Jorde 1982.

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

     Phi(S, P, N, n)

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

       S: the sistematic pressure matrix, where the diagonal elements
          are 1-sk, with sk the sistematic pressure for the k-th
          population, and the non diagonal elements are 0 

       P: the column stochastic migration matrix, possibly obtained
          using col.sto on the "raw" migration matrix 

       N: the vector of effective populations, where each element is
          the population size for all the n populations divided by 3 

       n: the number of iterations needed to reach the equilibrium,
          calculated by the function Mal.eq 

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

     The Malecot model is simply an iterative markow-chain-like process
     that gives rise to an asymptotic growth curve, so that an
     equilibrium is reached after a number of iterations.

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

     Returns a square and symmetrical matrix.

_N_o_t_e:

     ...

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

     Federico C. F. Calboli f.calboli@ucl.ac.uk

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

     Imaizumi, Y., N. E. Morton and D. E. Harris. 1970. Isolation by
     distance in artificial populations. Genetics 66: 569-582.

     Jorde, L. B. 1982. The genetic structure of the Utah mormons:
     migration analysis. Human Biology 54(3): 583-597.

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

     'Mal.eq' for the function generating the number of cycles needed
     to reach the asymptotic value

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

     # using Swedlund data again...
     data(S); data(P); data(N)
     x<-Mal.eq(S,P,N)
     phi<-Phi(S,P,N,x)
     phi

