Description
Summarize counts below a supplied rarity cutoff, with exact decimal totals and an approximate numeric share.
Ecological sampling summaries distinguish effort, weighted support, taxon counts and relative composition. A denominator-specific fraction or single-species contribution need not describe abundance, completeness or a whole-community index.
Summarize counts below a supplied rarity cutoff, with exact decimal totals and an approximate numeric share.
When to use this tool
Use Community Rare Count Share when checking a supplied ecological effort, support or count convention.
How to use the tool and how it works
- Enter taxonCounts, suppliedRareMaximum. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read totalCountDecimal, rareCountDecimal, rareTaxa, share, defined. Inspect defined before interpreting the associated values.
Require nonnegative whole taxonCounts and nonnegative whole suppliedRareMaximum. Sum all counts and positive counts <= the rare threshold with exact integer arithmetic. Return exact decimal totals, rareTaxa, and rare/total as a numeric share, or zero with defined = false at zero total.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| taxonCounts | Taxon Counts | Required. Array of safe integer; minimum 0; maximum items 256. |
| suppliedRareMaximum | Supplied Rare Maximum | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| totalCountDecimal | Total Count Decimal | Required. Text; maximum UTF-16 length 8192. |
| rareCountDecimal | Rare Count Decimal | Required. Text; maximum UTF-16 length 8192. |
| rareTaxa | Rare Taxa | Required. Safe integer. |
| share | Approximate numeric rare-count/total ratio; exact totals are returned as decimal strings. | Required. Finite number. |
| defined | Whether the stated denominator has positive support; read this before interpreting a zero placeholder. | Required. Boolean. |
{
"input": {
"taxonCounts": [
1,
2,
5
],
"suppliedRareMaximum": 2
},
"output": {
"totalCountDecimal": "8",
"rareCountDecimal": "3",
"rareTaxa": 2,
"share": 0.375,
"defined": true
}
}Limitations and assumptions
- Zero-abundance taxa are not rare taxa here. The threshold is supplied; numeric share is approximate even though total strings are exact, and rarity does not establish conservation status.
- 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.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use an appropriate sampling, detection and community-analysis method for inference beyond these local summaries.
References
Similar or alternative tools
- Insect Count Subsample Share
share = subsampleCount/totalCount when totalCount > 0; otherwise return share = 0 and defined = false.
- Community Composition One Species Turnover
Compare one species’ abundance shares and return its raw Bray-Curtis numerator contribution.