Description
Return observed share under supplied rare-taxon flags.
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 observed share under supplied rare-taxon flags.
When to use this tool
Use Rare Species Observation Share when checking the stated biodiversity record, effort, count or support convention.
How to use the tool and how it works
- Enter counts, suppliedRare. 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 rareCount, totalCount, share, defined. Inspect defined before interpreting the associated values.
Return observed share under supplied rare-taxon flags. Require aligned nonnegative counts/flags; rareCount sums flagged rows, share divides by totalCount or is zero with defined false at zero total.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| counts | Counts | Required. Array of safe integer; minimum 0; maximum items 256. |
| suppliedRare | Supplied Rare | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| rareCount | Rare Count | Required. Safe integer. |
| totalCount | Total Count | Required. Safe integer. |
| share | Dimensionless numerator/denominator ratio under the explicit basis above. | Required. Finite number. |
| defined | Whether the stated denominator or information basis supports this value; inspect placeholders before interpretation. | Required. Boolean. |
{
"input": {
"counts": [
2,
6,
2
],
"suppliedRare": [
true,
false,
true
]
},
"output": {
"rareCount": 4,
"totalCount": 10,
"share": 0.4,
"defined": true
}
}Limitations and assumptions
- Counts are nonnegative whole observations; rarity is supplied, not inferred from abundance or a conservation classification.
- 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
- Survey Visit Detection Support
Return visit-level detection share for one selected taxon.
- Taxon Incidence Support Count
Count presences with and without sampling support.