surnames               package:Biodem               R Documentation

_S_u_r_n_a_m_e _f_r_e_q_u_e_n_c_y _t_a_b_l_e

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

     A surname frequency table, with 3 populations and 5 surnames.

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

     data(surnames)

_F_o_r_m_a_t:

     A 5 rows by 3 columns dataset

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

     Surname frequency tables are the argument needed in all the
     surname-based inter-population analysis functions (e.g. "lasker",
     "hedrick", "uri", etc.). Surname frequency tables can be generated
     from marriage and marriage-like data (e.g. data that contain
     couples of related surnames) using the "sur.freq" function.  In
     order to generate surname frequency tables from other surname
     sources (e.g. telephone directories, registers of voters, etc.)
     see the example in this help page. To import correctly surnames
     data bases in R see the "valley" dataset help page.

_S_o_u_r_c_e:

     Alessio Boattini. Dummy dataset generated for testing and example
     purposes

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

     data(surnames)

     # NB. How did we produce the "surnames" dataset?
     # the original data (an hypothetic list of surnames)
     # were arranged as:

     #  YEAR POP SURNAME
     #  1901   3  FABBRI
     #  1901   3  VITALI
     #  1901   2   LIPPI
     #  1901   2  FABBRI
     #  1901   2   NARDI
     #  1901   2   NARDI
     #  1901   1  ANGELI
     #  1902   1  ANGELI
     #  1902   2  VITALI
     #  1902   2   LIPPI
     #  1902   1   LIPPI
     #  1902   1   LIPPI
     #  1902   3  VITALI
     #  1902   3  FABBRI
     #  1902   2  FABBRI
     #  1904   2   NARDI
     #  1904   2   NARDI
     #  1904   2   LIPPI
     #  1905   1  VITALI
     #  1905   1  FABBRI
     #  1905   3  FABBRI
     #  1905   3  ANGELI
     #  1905   2   LIPPI
     #  1905   2   NARDI
     #  1905   3   NARDI
     #  1905   3   NARDI

     #       ..........

     # This arrangement does not necessarily reflect
     # the way other people would arrange their data. 
     # The "surnames" dataset was generated using
     # the "table" function as follows:

     # table(data$SURNAME,data$POP)

