summary.capthist: Summarise Detections

Description Usage Arguments Details Value See Also Examples

View source: R/summary.capthist.R

Description

Concise description of capthist object.

Usage

1
2
3
4
5
6
7
## S3 method for class 'capthist'
summary(object, terse = FALSE, moves = FALSE, ...)

## S3 method for class 'summary.capthist'
print(x, ...)

counts(CHlist, counts = "M(t+1)")

Arguments

object

capthist object

terse

logical; if TRUE return only summary counts

moves

logical; if TRUE then summary includes detected movements

x

summary.capthist object

...

arguments passed to other functions

CHlist

capthist object, especially a multi-session object

counts

character vector of count names

Details

These counts are reported by summary.capthist

n number of individuals detected on each occasion
u number of individuals detected for the first time on each occasion
f number of individuals detected exactly f times
M(t+1) cumulative number of individuals detected
losses number of individuals reported as not released on each occasion
detections number of detections, including within-occasion `recaptures'
traps visited number of detectors at which at least one detection was recorded
traps set number of detectors, excluding any `not set' in usage attribute of traps attribute

The last two rows are dropped if the data are nonspatial (object has no traps attribute).

Movements are as reported by moves. When terse = TRUE the number of non-zero moves is reported. The temporal sequence of detections at ‘proximity’ and ‘count’ detectors is not recorded in the capthist object, so the movement statistics are not to be taken too seriously. The problem is minimised when detections are sparse (seldom more than one per animal per occasion), and does not occur with 'single' or 'multi' detectors.

counts may be used to return the specified counts in a compact session x occasion table. If more than one count is named then a list is returned with one component for each type of count.

Value

From summary.capthist, an object of class summary.capthist, a list with at least these components

detector

detector type ("single", "multi", "proximity" etc.)

ndetector

number of detectors

xrange

range of x coordinates of detectors

yrange

range of y coordinates of detectors

spacing

mean distance from each trap to nearest other trap

counts

matrix of summary counts (rows) by occasion (columns). See Details.

dbar

mean recapture distance

RPSV

root pooled spatial variance

or, when terse = TRUE, a vector (single session) or dataframe (multiple sessions) of counts (Occasions, Detections, Animals, Detectors, and optionally Moves).

A summary of individual covariates is provided if these are present (from secr 4.0.1).

See Also

dbar, RPSV, capthist

Examples

1
2
3
4
temptrap <- make.grid(nx = 5, ny = 3)
summary(sim.capthist(temptrap))
summary(sim.capthist(temptrap))$counts["n",]
summary(captdata, moves = TRUE)

Example output

This is secr 3.1.8. For overview type ?secr
Object class       capthist 
Detector type      multi (5) 
Detector number    15 
Average spacing    20 m 
x-range            0 80 m 
y-range            0 40 m 

Counts by occasion 
                   1  2  3  4  5 Total
n                  1  2  2  3  2    10
u                  1  2  0  1  1     5
f                  2  2  0  1  0     5
M(t+1)             1  3  3  4  5     5
losses             0  0  0  0  0     0
detections         1  2  2  3  2    10
detectors visited  1  2  2  3  2    10
detectors used    15 15 15 15 15    75
  1 2 3 4 5 Total
n 2 3 4 4 5    18
Object class       capthist 
Detector type      single 
Detector number    100 
Average spacing    30 m 
x-range            365 635 m 
y-range            365 635 m 

Counts by occasion 
                    1   2   3   4   5 Total
n                  48  46  47  47  47   235
u                  48  14   6   6   2    76
f                  17  10  15  17  17    76
M(t+1)             48  62  68  74  76    76
losses              0   0   0   0   0     0
detections         48  46  47  47  47   235
detectors visited  48  46  47  47  47   235
detectors used    100 100 100 100 100   500

secr documentation built on Oct. 18, 2021, 9:06 a.m.