Description Usage Arguments Details Value Note References See Also Examples
Compute HorvitzThompsonlike estimate of population density from a
previously fitted spatial detection model, and estimate its sampling
variance using the empirical spatial variance of the number observed
in replicate sampling units. Wrapper functions are provided for
several different scenarios, but all ultimately call
derivednj
. The function derived
also computes
HorvitzThompsonlike estimates, but it assumes a Poisson or binomial
distribution of total number when computing the sampling variance.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20  derivednj ( nj, esa, se.esa = NULL, method = c("SRS", "R2", "R3", "local",
"poisson", "binomial"), xy = NULL, alpha = 0.05, loginterval = TRUE,
area = NULL, independent.esa = FALSE )
derivedMash ( object, sessnum = NULL, method = c("SRS", "local"),
alpha = 0.05, loginterval = TRUE)
derivedCluster ( object, method = c("SRS", "R2", "R3", "local", "poisson", "binomial"),
alpha = 0.05, loginterval = TRUE)
derivedSession ( object, method = c("SRS", "R2", "R3", "local", "poisson", "binomial"),
xy = NULL, alpha = 0.05, loginterval = TRUE, area = NULL, independent.esa = FALSE )
derivedExternal ( object, sessnum = NULL, nj, cluster, buffer = 100,
mask = NULL, noccasions = NULL, method = c("SRS", "local"), xy = NULL,
alpha = 0.05, loginterval = TRUE)
derivedSystematic( object, xy, design = list(), basenx = 10, df = 9, extrapolate = TRUE,
alpha = 0.05, loginterval = TRUE, independent.esa = FALSE, keep = FALSE,
ncores = NULL)

object 
fitted secr model 
nj 
vector of number observed in each sampling unit (cluster) 
esa 
estimate of effective sampling area (ahat) 
se.esa 
estimated standard error of effective sampling area (SEhat(ahat)) 
method 
character string ‘SRS’ or ‘local’ 
xy 
dataframe of x and y coordinates ( 
alpha 
alpha level for confidence intervals 
loginterval 
logical for whether to base interval on log(N) 
area 
area of region for method = "binomial" (hectares) 
independent.esa 
logical; controls variance contribution from esa (see Details) 
sessnum 
index of session in object$capthist for which output required 
cluster 
‘traps’ object for a single cluster 
buffer 
width of buffer in metres (ignored if 
mask 
mask object for a single cluster of detectors 
noccasions 
number of occasions (for 
design 
list specifying systematic design (see Details) 
basenx 
integer number of basis grid points in xdimension 
df 
integer number of degrees of freedom for gam 
extrapolate 
logical; if FALSE then boxlet p values are inferred from nearest point inside convex hull of grid 
keep 
logical; if TRUE then derivedSystematic saves key intermediate values as attributes 
ncores 
integer 
derivednj
accepts a vector of counts (nj
), along with
ahat and SE(ahat). The
argument esa
may be a scalar or (if se.esa is NULL)
a 2column matrix with a_jhat and
SE(a_jhat) for each replicate j (row).
In the special case that nj
is of length 1, or method
takes the values ‘poisson’ or
‘binomial’, the variance is computed using a theoretical variance
rather than an empirical estimate. The value of method
corresponds to ‘distribution’ in derived
, and defaults to
‘poisson’. For method = 'binomial'
you must specify area
(see Examples).
If independent.esa
is TRUE then independence is assumed among
clusterspecific estimates of esa, and esa variances are summed. The default
is a weighted sum leading to higher overall variance.
derivedCluster
accepts a model fitted to data from clustered
detectors; each cluster is interpreted as a replicate
sample. It is assumed that the sets of individuals sampled by
different clusters do not intersect, and that all clusters have the
same geometry (spacing, detector number etc.).
derivedMash
accepts a model fitted to clustered data that have
been ‘mashed’ for fast processing (see mash
); each
cluster is a replicate sample: the function uses the vector of cluster
frequencies (n_j) stored as an attribute of the mashed
capthist
by mash
.
derivedExternal
combines detection parameter estimates from a
fitted model with a vector of frequencies nj
from replicate
sampling units configured as in cluster
. Detectors in
cluster
are assumed to match those in the fitted model with
respect to type and efficiency, but sampling duration
(noccasions
), spacing etc. may differ. The mask
should
match cluster
; if mask
is missing, one will be
constructed using the buffer
argument and defaults from
make.mask
.
derivedSession
accepts a single fitted model that must span
multiple sessions; each session is interpreted as a replicate sample.
Spatial variance is calculated by one of these methods
Method  Description 
"SRS"  simple random sampling with identical clusters 
"R2"  variable cluster size cf Thompson (2002:70) estimator for line transects 
"R3"  variable cluster size cf Buckland et al. (2001) 
"local"  neighbourhood variance estimator (Stevens and Olsen 2003) 
"poisson"  theoretical (modelbased) variance 
"binomial"  theoretical (modelbased) variance in given area 
The weighted options R2 and R3 substitute a_jhat for line length l_k in the corresponding formulae of Fewster et al. (2009, Eq 3,5). Density is estimated by \hat D = n/A where A = ∑ a_j. The variance of A is estimated as the sum of the clusterspecific variances, assuming independence among clusters. Fewster et al. (2009) found that an alternative estimator for line transects derived by Thompson (2002) performed better when there were strong density gradients correlated with line length (R2 in Fewster et al. 2009, Eq 3).
The neighborhood variance estimator is implemented in package spsurvey and was originally proposed for generalized random tessellation stratified (GRTS) samples. For ‘local’ variance
estimates, the centre of each replicate must be provided in xy
,
except where centres may be inferred from the data. It is unclear whether ‘local’ can or should be used when clusters vary in size.
derivedSystematic
implements the 'boxlet' variance estimator of Fewster (2011) for systematic designs using clustered detectors (an alternative to derivedCluster
and derivedSessions
). The method is experimental in secr 3.2.0 and may change. The ‘design’ argument is a list with components corresponding to arguments of make.systematic
, (n
and origin
are ignored if provided):
Component  Description 
cluster  traps object for a single cluster 
region  2column matrix or SpatialPolygons 
spacing  spacing between cluster origins 
...  other arguments passed to trap.builder 
e.g. edgemethod , exclude , exclmethod 

If region
is omitted from design
then an attempt will be made to retrieve it from the mask attribute of object
(this works if the call to make.mask
used keep.poly = TRUE
).
Dataframe with one row for each derived parameter (‘esa’, ‘D’) and columns as below
estimate  estimate of derived parameter 
SE.estimate  standard error of the estimate 
lcl  lower 100(1alpha)% confidence limit 
ucl  upper 100(1alpha)% confidence limit 
CVn  relative SE of number observed (across sampling units) 
CVa  relative SE of effective sampling area 
CVD  relative SE of density estimate 
The variance of a HorvitzThompsonlike estimate of density may be estimated as the sum of two components, one due to uncertainty in the estimate of effective sampling area (ahat) and the other due to spatial variance in the total number of animals n observed on J replicate sampling units (sum(n_j)). We use a deltamethod approximation that assumes independence of the components:
var(Dhat) = Dhat^2 (var(n)/n^2 + var(ahat)/ahat^2)
where var(n) = J/(J1).sum((n_j  n/J)^2). The estimate of var(ahat) is modelbased while that of var(n) is designbased. This formulation follows that of Buckland et al. (2001, p. 78) for conventional distance sampling. Given sufficient independent replicates, it is a robust way to allow for unmodelled spatial overdispersion.
There is a complication in SECR owing to the fact that
ahat is a derived quantity (actually an integral)
rather than a model parameter. Its sampling variance
var(ahat) is estimated indirectly in
secr by combining the asymptotic estimate of the covariance
matrix of the fitted detection parameters theta with a
numerical estimate of the gradient of a(theta) with
respect to theta. This calculation is performed in
derived
.
Buckland, S. T., Anderson, D. R., Burnham, K. P., Laake, J. L., Borchers, D. L. and Thomas, L. (2001) Introduction to Distance Sampling: Estimating Abundance of Biological Populations. Oxford University Press, Oxford.
Fewster, R. M. (2011) Variance estimation for systematic designs in spatial surveys. Biometrics 67, 1518–1531.
Fewster, R. M., Buckland, S. T., Burnham, K. P., Borchers, D. L., Jupp, P. E., Laake, J. L. and Thomas, L. (2009) Estimating the encounter rate variance in distance sampling. Biometrics 65, 225–236.
Stevens, D. L. Jr and Olsen, A. R. (2003) Variance estimation for spatially balanced samples of environmental resources. Environmetrics 14, 593–610.
Thompson, S. K. (2002) Sampling. 2nd edition. Wiley, New York.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105  ## The `ovensong' data are pooled from 75 replicate positions of a
## 4microphone array. The array positions are coded as the first 4
## digits of each sound identifier. The sound data are initially in the
## object `signalCH'. We first impose a 52.5 dB signal threshold as in
## Dawson & Efford (2009, J. Appl. Ecol. 46:12011209). The vector nj
## includes 33 positions at which no ovenbird was heard. The first and
## second columns of `temp' hold the estimated effective sampling area
## and its standard error.
## Not run:
signalCH.525 < subset(signalCH, cutval = 52.5)
nonzero.counts < table(substring(rownames(signalCH.525),1,4))
nj < c(nonzero.counts, rep(0, 75  length(nonzero.counts)))
temp < derived(ovensong.model.1, se.esa = TRUE)
derivednj(nj, temp["esa",1:2])
## The result is very close to that reported by Dawson & Efford
## from a 2D Poisson model fitted by maximizing the full likelihood.
## If nj vector has length 1, a theoretical variance is used...
msk < ovensong.model.1$mask
A < nrow(msk) * attr(msk, "area")
derivednj (sum(nj), temp["esa",1:2], method = "poisson")
derivednj (sum(nj), temp["esa",1:2], method = "binomial", area = A)
## Set up an array of small (4 x 4) grids,
## simulate a Poissondistributed population,
## sample from it, plot, and fit a model.
## mash() condenses clusters to a single cluster
testregion < data.frame(x = c(0,2000,2000,0),
y = c(0,0,2000,2000))
t4 < make.grid(nx = 4, ny = 4, spacing = 40)
t4.16 < make.systematic (n = 16, cluster = t4,
region = testregion)
popn1 < sim.popn (D = 5, core = testregion,
buffer = 0)
capt1 < sim.capthist(t4.16, popn = popn1)
fit1 < secr.fit(mash(capt1), CL = TRUE, trace = FALSE)
## Visualize sampling
tempmask < make.mask(t4.16, spacing = 10, type =
"clusterbuffer")
plot(tempmask)
plot(t4.16, add = TRUE)
plot(capt1, add = TRUE)
## Compare modelbased and empirical variances.
## Here the answers are similar because the data
## were simulated from a Poisson distribution,
## as assumed by \code{derived}
derived(fit1)
derivedMash(fit1)
## Now simulate a patchy distribution; note the
## larger (and more credible) SE from derivedMash().
popn2 < sim.popn (D = 5, core = testregion, buffer = 0,
model2D = "hills", details = list(hills = c(2,3)))
capt2 < sim.capthist(t4.16, popn = popn2)
fit2 < secr.fit(mash(capt2), CL = TRUE, trace = FALSE)
derived(fit2)
derivedMash(fit2)
## The detection model we have fitted may be extrapolated to
## a more finegrained systematic sample of points, with
## detectors operated on a single occasion at each...
## Total effort 400 x 1 = 400 detectoroccasions, compared
## to 256 x 5 = 1280 detectoroccasions for initial survey.
t1 < make.grid(nx = 1, ny = 1)
t1.100 < make.systematic (cluster = t1, spacing = 100,
region = testregion)
capt2a < sim.capthist(t1.100, popn = popn2, noccasions = 1)
## one way to get number of animals per point
nj < attr(mash(capt2a), "n.mash")
derivedExternal (fit2, nj = nj, cluster = t1, buffer = 100,
noccasions = 1)
## Review plots
library(MASS)
base.plot < function() {
eqscplot( testregion, axes = FALSE, xlab = "",
ylab = "", type = "n")
polygon(testregion)
}
par(mfrow = c(1,3), xpd = TRUE, xaxs = "i", yaxs = "i")
base.plot()
plot(popn2, add = TRUE, col = "blue")
mtext(side=3, line=0.5, "Population", cex=0.8, col="black")
base.plot()
plot (capt2a, add = TRUE,title = "Extensive survey")
base.plot()
plot(capt2, add = TRUE, title = "Intensive survey")
par(mfrow = c(1,1), xpd = FALSE, xaxs = "r", yaxs = "r") ## defaults
## Weighted variance
derivedSession(ovenbird.model.1, method = "R2")
## End(Not run)

Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.