ucare: Goodness-of-fit tests for the Cormack-Jolly-Seber model

Description Usage Arguments Details Value References See Also Examples


The package R2ucare (Gimenez et al. 2017, 2018) provides the standard tests for CJS models from Burnham et al. (1987) along with tests for multi-state models as described by Pradel et al. (2005). This function is a wrapper for the tests relevant to openCR (see Details). Original papers and the associated vignette for R2ucare should be consulted for interpretation.


ucare.cjs(CH, tests = "all", by = NULL, verbose = TRUE, rounding = 3, ...)



capthist object suitable for openCR


character vector with the names of specific tests (see Details) or ‘all’


character name of covariate in CH used to split rows of CH into separate groups


logical; if TRUE then additional details are tabulated


integer number of decimal places in output


other arguments passed to split.capthist if needed


The possible tests are “test3sr", “test3sm", “test2ct", “test2cl", and “overall_CJS".

If CH is a multi-session object then it will first be collapsed to a single-session object with join as usual in openCR. If CH has an intervals attribute indicating that the data are from a robust design (some intervals zero) then it will first be collapsed to one secondary session per primary session, with a warning.

If by is specified it should point to a categorical variable (factor or character) in the covariates attribute of CH. Separate tests will be conducted for each group.


A list of results, possibly nested by the grouping variable by. The verbose form includes both the overall result of each test and its breakdown into components (‘details’).


Burnham, K. P., Anderson, D. R., White, G. C., Brownie, C. and Pollock, K. H. (1987) Design and Analysis Methods for Fish Survival Experiments Based on Release-Recapture. American Fisheries Society Monograph 5. Bethesda, Maryland, USA.

Choquet, R., Lebreton, J.-D., Gimenez, O., Reboulet, A.-M. and Pradel, R. (2009) U-CARE: Utilities for performing goodness of fit tests and manipulating CApture-REcapture data. Ecography 32, 1071–1074.

Gimenez, O., Lebreton, J.-D., Choquet, R. and Pradel, R. (2017) R2ucare: Goodness-of-Fit Tests for Capture-Recapture Models. R package version 1.0.0. https://CRAN.R-project.org/package=R2ucare/

Gimenez, O., Lebreton, J.-D., Choquet, R. and Pradel, R. (2018) R2ucare: An R package to perform goodness-of-fit tests for capture–recapture models. Methods in Ecology and Evolution 9, 1749–1754.

Lebreton, J.-D., Burnham, K. P., Clobert, J., and Anderson, D. R. (1992) Modeling survival and testing biological hypotheses using marked animals: a unified approach with case studies. Ecological Monographs 62, 67–118.

Pradel, R., Gimenez O. and Lebreton, J.-D. (2005) Principles and interest of GOF tests for multistate capture–recapture models. Animal Biodiversity and Conservation 28, 189–204.

See Also



if (requireNamespace("R2ucare"))
    ucare.cjs(dipperCH, verbose = FALSE, by = 'sex')

openCR documentation built on May 16, 2021, 1:06 a.m.