periodhist             package:Rcapture             R Documentation

_C_a_p_t_u_r_e _H_i_s_t_o_r_i_e_s _B_e_t_w_e_e_n _P_r_i_m_a_r_y _S_a_m_p_l_i_n_g _P_e_r_i_o_d_s

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

     This function produces the matrix of capture histories between
     primary sampling periods from a complete matrix of capture
     histories for a robust design.

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

     periodhist(X, dfreq=FALSE, vt)

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

       X: The table of the observed capture histories in one of the two
          accepted formats. In the default format, it has one row per
          unit captured in the experiment and sum(vt) columns. In the
          alternative format, it contains one row per capture history
          followed by its frequency. In that case, 'X' has sum(vt)+1
          columns. The first sum(vt) columns of 'X', identifying the
          capture histories, must contain only zeros and ones. The
          number one indicates a capture. 

   dfreq: This argument specifies the format of the data matrix 'X'. By
          default, it is set to FALSE, which means that 'X' has one row
          per unit. If it is set to TRUE, then the matrix 'X' contains
          frequencies in its last column.

      vt: A vector containing the numbers of capture occasions for each
          primary sampling period of a robust design. The length of
          this vector equals the number of primary sampling periods
          (noted I). 

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

     This function is useful when using an open population model to
     analyse a robust design data set. It reduces the data set to one
     observation per primary period. The observation is one for a unit
     caught at least once during the period and zero for a unit never
     caught. If a data matrix produced by the 'periodhist' function is
     given in argument to an 'openp' function, the 'dfreq' argument
     must be set to TRUE.

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

     A 2^I-1 by I+1 matrix of all the possible between periods capture
     histories, with their observed frequencies. This data matrix has
     the alternative format.

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

     Sophie Baillargeon sbaillar@mat.ulaval.ca and Louis-Paul Rivest
     lpr@mat.ulaval.ca

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

     Baillargeon, S. and Rivest, L.P. (2007). The Rcapture package:
     Loglinear models for capture-recapture in R. _Journal of
     Statistical Software_, to appear (available online at <URL:
     http://www.jstatsoft.org/>).

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

     'openp'

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

     data(mvole)
     mvole.op<-periodhist(mvole,vt=rep(5,6))
     openp(mvole.op, dfreq=TRUE)

