Description
Return visit-level detection share for one selected taxon.
Biodiversity summaries depend on taxon concepts, sampling effort, detection and missing-status policies. Literal labels and observed shares can organize records while species identity, true abundance, occupancy and conservation status require appropriate ecological evidence and analysis.
Return visit-level detection share for one selected taxon.
When to use this tool
Use Survey Visit Detection Support when checking the stated biodiversity record, effort, count or support convention.
How to use the tool and how it works
- Enter visitIds, taxonIds, detected, selectedTaxon. Follow any array-alignment requirements below. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read surveyedVisits, detectingVisits, detectionShare, defined. Inspect defined before interpreting the associated values.
Return visit-level detection share for one selected taxon. Require aligned arrays; count distinct selected-taxon visits and visits with any detected row, divide or return zero with defined false when none.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| visitIds | Visit Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| taxonIds | Taxon Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| detected | Detected | Required. Array of boolean; maximum items 256. |
| selectedTaxon | Selected Taxon | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| surveyedVisits | Surveyed Visits | Required. Safe integer. |
| detectingVisits | Detecting Visits | Required. Safe integer. |
| detectionShare | Distinct visits with a supplied detection divided by selected-taxon visits; not modeled detection probability. | Required. Finite number. |
| defined | Whether the stated denominator or information basis supports this value; inspect placeholders before interpretation. | Required. Boolean. |
{
"input": {
"visitIds": [
"v1",
"v1",
"v2"
],
"taxonIds": [
"t",
"t",
"t"
],
"detected": [
true,
false,
false
],
"selectedTaxon": "t"
},
"output": {
"surveyedVisits": 2,
"detectingVisits": 1,
"detectionShare": 0.5,
"defined": true
}
}Limitations and assumptions
- This is observed visit coverage, not a fitted detection probability, occupancy estimate or inference about unsurveyed sites.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Use source-aware taxonomy, verified field records and a suitable sampling/detection model for ecological estimates, uncertainty or conservation conclusions.
References
Similar or alternative tools
- Taxon Incidence Support Count
Count presences with and without sampling support.
- Rare Species Observation Share
Return observed share under supplied rare-taxon flags.