dht.se | R Documentation |
Computes standard error, cv, and log-normal confidence intervals for abundance and density within each region (if any) and for the total of all the regions. It also produces the correlation matrix for regional and total estimates.
dht.se(
model,
region.table,
samples,
obs,
options,
numRegions,
estimate.table,
Nhat.by.sample
)
model |
ddf model object |
region.table |
table of region values |
samples |
table of samples(replicates) |
obs |
table of observations |
options |
list of options that can be set (see |
numRegions |
number of regions |
estimate.table |
table of estimate values |
Nhat.by.sample |
estimated abundances by sample |
The variance has two components:
variation due to uncertainty from estimation of the detection function parameters;
variation in abundance due to random sample selection;
The first component (model parameter uncertainty) is computed using a delta
method estimate of variance (Huggins 1989, 1991, Borchers et al. 1998) in
which the first derivatives of the abundance estimator with respect to the
parameters in the detection function are computed numerically (see
DeltaMethod
).
The second component (encounter rate variance) can be computed in one of
several ways depending on the form taken for the encounter rate and the
estimator used. To begin with there three possible values for varflag
to calculate encounter rate:
0
uses a binomial variance for the number of observations
(equation 13 of Borchers et al. 1998). This estimator is only useful if the
sampled region is the survey region and the objects are not clustered; this
situation will not occur very often;
1
uses the encounter rate n/L
(objects observed per unit
transect) from Buckland et al. (2001) pg 78-79 (equation 3.78) for line
transects (see also Fewster et al, 2009 estimator R2). This variance
estimator is not appropriate if size
or a derivative of size
is used in the detection function;
2
is the default and uses the encounter rate estimator
\hat{N}/L
(estimated abundance per unit transect) suggested by Innes
et al (2002) and Marques & Buckland (2004).
In general if any covariates are used in the models, the default
varflag=2
is preferable as the estimated abundance will take into
account variability due to covariate effects. If the population is clustered
the mean group size and standard error is also reported.
For options 1
and 2
, it is then possible to choose one of the
estimator forms given in Fewster et al (2009). For line transects:
"R2"
, "R3"
, "R4"
, "S1"
, "S2"
,
"O1"
, "O2"
or "O3"
can be used by specifying the
ervar=
option (default "R2"
). For points, either the
"P2"
or "P3"
estimator can be selected (>=mrds 2.3.0
default "P2"
, <= mrds 2.2.9 default "P3"
). See
varn
and Fewster et al (2009) for further details
on these estimators.
Exceptions to the above occur if there is only one sample in a stratum. In
that case it uses Poisson assumption (Var(x)=x
) and it assumes a known
variance so z=1.96
is used for critical value. In all other cases the
degrees of freedom for the t
-distribution assumed for the
log(abundance) or log(density) is based on the Satterthwaite approximation
(Buckland et al. 2001 pg 90) for the degrees of freedom (df). The df are
weighted by the squared cv in combining the two sources of variation because
of the assumed log-normal distribution because the components are
multiplicative. For combining df for the sampling variance across regions
they are weighted by the variance because it is a sum across regions.
A non-zero correlation between regional estimates can occur from using a common detection function across regions. This is reflected in the correlation matrix of the regional and total estimates which is given in the value list. It is only needed if subtotals of regional estimates are needed.
List with 2 elements:
estimate.table |
completed table with se, cv and confidence limits |
vc |
correlation matrix of estimates |
This function is called by dht
and it is not expected that the
user will call this function directly but it is documented here for
completeness and for anyone expanding the code or using this function in
their own code.
Jeff Laake
see dht
dht
, print.dht
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.