See unmarkedFrame
and unmarkedFrameOccuFP
for a
description of how to supply data to the data
argument.
occuFP
fits an extension of the standard single-season occupancy model (MacKenzie et al. 2002), which allows
false positive detections. The occupancy status of a site is the same way as with the occu
function, where stateformula
is used to specify factors that lead to differences in occupancy probabilities among sites.
The observation process differs in that both false negative and false positive errors are modeled for observations. The
function allows data to be of 3 types. These types are specified using in unmarkedFrameOccuFP
as type. Occassions
are specified to belong to 1 of the 3 data types and all or a subset of the data types can be combined in the same model.
For type 1 data, the detection process is assumed to fit the assumptions of the standard MacKenzie model
where false negative probabilities are estimated but false positive detections are assumed not to occur. If all of your
data is of this type you should use codeoccu to analyze data. The detection parameter p, which is modeled using the
detformula is the only observation parameter for these data.
For type 2 data, both false negative and false positive detection probabilities are estimated. If all data is of this
type the likelihood follows Royle and Link (2006). Both p (the true positive detection probability) and fp (the false
positive detection probability described by fpformula) are estimated for occassions when this data type occurs
For type 3 data, observations are assumed to include both certain detections (false positives assumed not to occur)
and uncertain detections that may include false positive detections. When only this data type occurs, the estimator
is the same as the multiple detection state model described in Miller et al. (2011). Three observation parameters occur
for this data type: p - true positive detection probability, fp - false positive detection probability, and b - the
probability a true positive detection was designated as certain.
When both type 1 and type 2 data occur, the estimator is equivalent to the multiple detection method model described
in Miller et al. (2011). The frog data example in the same paper uses an analysis where type 1 (dipnet surveys) and
type 3 (call surveys) data were used.
Data in the y matrix of the unmarked frame should be all 0s and 1s for
type 1 and type 2 data. For type 3 data, uncertain detections are given
a value of 1 and certain detections a value of 2.