BBRecap.custom.part {BBRecapture}R Documentation

Bayesian inference for behavioural effect models based on a partition of the set of all partial capture histories


Bayesian inference for a general model framework based on the capture probabilities conditioned on each possible partial capture history. As suggested in Alunni Fegatelli and Tardella (2012) the conditional approach originally proposed in Farcomeni (2011) [saturated reparameterization] is reviewed in terms of partitions into equivalence classes of conditional probabilities. In this function the user can directly provide the model as a partition.


BBRecap.custom.part (data,last.column.count=FALSE, partition, neval = 1000,
   by.incr = 1, prior.N = c("Rissanen", "Uniform", "one.over.N", "one.over.N2"),
   output = c("base", "complete"))



can be one of the following:

  1. an M by t binary matrix/data.frame. In this case the input is interpreted as a matrix whose rows contain individual capture histories for all M observed units

  2. a matrix/data.frame with (t+1) columns. The first t columns contain binary entries corresponding to capture occurrences, while the last column contains non negative integers corresponding to frequencies. This format is allowed only when last.column.count is set to TRUE

  3. a t-dimensional array or table representing the counts of the 2^t contingency table of binary outcomes

M is the number of units captured at least once and t is the number of capture occasions.


a logical. In the default case last.column.count=FALSE each row of the input argument data represents the complete capture history for each observed unit. When last.column.count is set to TRUE in each row the first t entries represent one of the observed complete capture histories and the last entry in the last column is the number of observed units with that capture history


list. partition represents a partition of the set of all partial capture histories.


a positive integer. neval is the number of values of the population size N where the posterior is evaluated starting from M. The default value is neval=1000.


a positive integer. by.incr represents the increment on the sequence of possible population sizes N where the posterior is evaluated. The default value is by.incr=1. The use of by.incr>1 is discouraged unless the range of N values of interest is very large


a character. prior.N is the label for the prior distribution for N. When prior.N is set to "Rissanen" (default) the Rissanen prior is used as a prior on N. This distribution was first proposed in Rissanen 1983 as a universal prior on integers. prior.N="Uniform" stands for a prior on N proportional to a constant value. prior.N="one.over.N" stands for a prior on N proportional to 1/N. prior.N="one.over.N2" stands for a prior on N proportional to 1/N^2.


a character. output selects the kind of output from a very basic summary info on the posterior output (point and interval estimates for the unknown N) to more complete details


Uniform prior distribution is considered for the nuisance parameters.



prior distribution for N.


posterior mean for N


posterior median for N


posterior mode for N


minimizer of a specific loss function connected with the Relative Mean Square Error.


95 \% highest posterior density interval estimate for N.


log marginal likelihood.


values of N considered.


values of the posterior distribution for each N considered


partition of the set H


Danilo Alunni Fegatelli and Luca Tardella


Farcomeni A. (2011) Recapture models under equality constraints for the conditional capture probabilities. Biometrika 98(1):237–242

Alunni Fegatelli, D. and Tardella, L. (2012) Improved inference on capture recapture models with behavioural effects. Statistical Methods & Applications Applications Volume 22, Issue 1, pp 45-66 10.1007/s10260-012-0221-4

Alunni Fegatelli D. (2013) New methods for capture-recapture modelling with behavioural response and individual heterogeneity.

See Also, LBRecap.custom.part, BBRecap



[Package BBRecapture version 0.2 Index]