| kfn {secr} | R Documentation |
Computes the overlap index of Efford et al. (2016) from various inputs, including fitted models.
kfn(object)
object |
fitted secr model, numeric vector, matrix, dataframe |
kfn simply computes k = \sigma \sqrt D / 100, where \sigma is the sigma parameter of a fitted halfnormal detection function and D is the corresponding density estimate. The factor of 1/100 adjusts for the units used in secr (sigma in metres; D in animals per hectare).
Input may be in any of these forms
vector with D and sigma in the first and second positions.
matrix with each row as in (1)
dataframe such as produced by predict.secr with rows ‘D’ and ‘sigma’, and column ‘estimate’.
fitted secr model
a list of any of the above
Numeric vector with elements ‘D’, ‘sigma’ and ‘k’, or a matrix with these columns.
The index should not be taken too literally as a measure of overlap: it represents the overlap expected if activity centres are randomly distributed and if home ranges have bivariate normal utilisation. Thus it does not measure overlap due to social behaviour etc. except as that affects home range size.
The index may be estimated directly using the sigmak parameterization
(i.e., when sigmak appears in the model for secr.fit).
This provides SE and confidence limits for sigmak (= k). However,
the directly estimated value of sigmak lacks the unit correction and is
therefore 100 \times the value from kfn.
Efford, M. G., Dawson, D. K., Jhala, Y. V. and Qureshi, Q. (2016) Density-dependent home-range size revealed by spatially explicit capture–recapture. Ecography 39, 676–688.
predict.secr, secr.fit, details
kfn(secrdemo.0)
## compare
## fitk <- secr.fit(captdata, model = sigmak~1, buffer = 100, trace = FALSE)
## predict(fitk)