Description
Return known-trait share under an unknown-status policy.
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 known-trait share under an unknown-status policy.
When to use this tool
Use Trait Unknown Value Denominator when checking the stated biodiversity record, effort, count or support convention.
How to use the tool and how it works
- Enter known, unknown, excluded, includeUnknown. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read denominator, knownShare, unknownShare. Use the output convention below.
Return known-trait share under an unknown-status policy. Require known >= 1 and unknown/excluded nonnegative whole; denominator adds unknown only when includeUnknown, while unknownShare always uses known+unknown+excluded.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| known | Supplied knowledge or lexical-recognition flag under the stated convention, without independent authentication. | Required. Safe integer; minimum 1. |
| unknown | Unknown | Required. Safe integer; minimum 0. |
| excluded | Excluded | Required. Safe integer; minimum 0. |
| includeUnknown | Include Unknown | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| denominator | Denominator | Required. Safe integer. |
| knownShare | Known Share Unit: 1. | Required. Finite number. |
| unknownShare | unknown/(known+unknown+excluded), independently of includeUnknown reporting policy. Unit: 1. | Required. Finite number. |
{
"input": {
"known": 8,
"unknown": 2,
"excluded": 0,
"includeUnknown": true
},
"output": {
"denominator": 10,
"knownShare": 0.8,
"unknownShare": 0.2
}
}Limitations and assumptions
- The two shares deliberately use different bases; no trait imputation, taxon identity or biodiversity estimate is supplied.
- 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 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 Unresolved Count Weight
Return a supplied unresolved-taxon weighted count.
- Taxon Incidence Support Count
Count presences with and without sampling support.