Description
Return distinct taxa supported by current accepted-concept records.
Taxonomic names, authorship strings, nomenclatural types and source-defined taxon concepts are related but distinct records. A literal token parser or source-label comparison can preserve a stated convention without resolving accepted taxonomy or establishing compliance with the applicable nomenclatural code.
Return distinct taxa supported by current accepted-concept records.
When to use this tool
Use Taxon Concept Support Share when checking the stated taxonomic source, name-token, date or concept-support convention.
How to use the tool and how it works
- Enter taxonIds, sourceConceptIds, acceptedConceptIds, currentSource. 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 taxa, supportedTaxa, share, defined. Inspect defined before interpreting the associated values.
Return distinct taxa supported by current accepted-concept records. Require aligned taxon/sourceConcept/current flags; any current row whose concept is in acceptedConceptIds supports its taxon, share divides supported distinct taxa by all or returns zero with defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| taxonIds | Taxon Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| sourceConceptIds | Source Concept Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| acceptedConceptIds | Accepted Concept Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| currentSource | Current Source | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| taxa | Taxa | Required. Safe integer. |
| supportedTaxa | Supported Taxa | Required. Safe integer. |
| share | Dimensionless numerator/denominator ratio under the explicit basis above. | Required. Finite number. |
| defined | Reporting flag under the explicit denominator or information policy above; inspect any zero placeholder or policy-defined value. | Required. Boolean. |
{
"input": {
"taxonIds": [
"a",
"b"
],
"sourceConceptIds": [
"c1",
"c2"
],
"acceptedConceptIds": [
"c1"
],
"currentSource": [
true,
true
]
},
"output": {
"taxa": 2,
"supportedTaxa": 1,
"share": 0.5,
"defined": true
}
}Limitations and assumptions
- Flags and concept lists are supplied; conflicting rows, source authority and actual taxonomic acceptance are not resolved.
- 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
Consult the original taxonomic treatment and applicable nomenclatural code, and use source-aware taxonomic resolution for accepted names, priority or type status.
References
Similar or alternative tools
- Character Source Ambiguity Gap
Summarize character-source ambiguity.
- Nomenclatural Type Status Source Token
Map a source type-status token through a supplied vocabulary.