Count of events flagged positive by at least one of several detectors
Source:R/callDensityEstimate.R
unionDetections.RdThe union-detector counterpart to Nc: rather than counting one
detector's own positive predictions, counts events flagged positive by
any of observerCols across the full capture history
table – the raw material a union call density estimate needs, matching
a whichObserver = "any" vglm's own union detection probability
(see pDetInArea).
cht should be the full table (every detection each contributing
detector made, whether adjudicated or not), not the small adjudicated
subset used to fit the detection function itself – the same distinction
Nc already makes for a single detector.
Arguments
- cht
Capture history table (matchbox-native or otherwise) with one logical column per contributing detector.
- observerCols
Character vector of column names to union.
- fullCoverageConfirmed
Logical, default
FALSE. Every contributing detector must have examined the same full extent of the data for this count to be a meaningful union – if one detector's own run only covers, say, a 200-hour subsample while another covers a full year, unioning their positive calls silently mixes two different denominators. This can't be verified from the capture history table alone – there's no "did this detector examine this moment" column, distinct from "did this detector flag this moment" – so it must be confirmed explicitly here, the same waycde'sNcIsTruncatedrequires confirming SNR truncation was applied consistently rather than silently assuming it.