histfreq              package:Rcapture              R Documentation

_F_r_e_q_u_e_n_c_i_e_s _o_f _t_h_e _P_o_s_s_i_b_l_e _C_a_p_t_u_r_e _H_i_s_t_o_r_i_e_s

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

     These functions compute the frequencies of all possible capture
     histories.
      'histfreq.t' is used for the 2^t-1 observable capture histories
     genereted by 'histpos.t' in terms of captures and misses for each
     of the t capture occasions. 
      'histfreq.0' is used for observable capture histories genereted
     by 'histpos.0' in terms of the numbers of captures in the primary
     periods of a robust design with 'vt' capture occasions.

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

     histfreq.t(X, dfreq=FALSE)
     histfreq.0(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. In this case, the number of
          columns in the table represents the number of capture
          occasions in the experiment (noted t). In the alternative
          format, it contains one row per capture history followed by
          its frequency. In that case, 'X' has t+1 columns. The first t
          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). 

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

     'histfreq.t' returns a vector of frequencies for the 2^t - 1 or
     2^sum(vt)-1 capture histories ordered as in 'histpos.t'. 

     'histfreq.0' returns a vector of frequencies for the
     (t1+1)*(t2+1)* cdots *(tI+1)-1 capture histories ordered as in
     'histpos.0' .

_N_o_t_e:

     The 'histfreq.t' function is called by 'descriptive', 'closedp',
     'closedp.bc', 'closedp.Mtb', 'closedp.mX', 'closedp.h',
     'periodhist', 'openp', 'robustd.t', 'robustd.0'.

     The 'histfreq.0' function is called by 'robustd.0'.

_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:

     'histpos.t', 'histpos.0', 'descriptive'

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

     data(mvole)

     period3<-mvole[,11:15]
     histfreq.t(period3)

     histfreq.0(mvole[,1:15],vt=rep(5,3))

