Description
Find a child/parent rank pair in a supplied vocabulary.
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.
Find a child/parent rank pair in a supplied vocabulary.
When to use this tool
Use Taxon Rank Supplied Parent Match when checking the stated taxonomic source, name-token, date or concept-support convention.
How to use the tool and how it works
- Enter childRank, parentRank, allowedChildren, allowedParents. 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 matches, matchingIndices. Inspect matches before interpreting the associated values.
Find a child/parent rank pair in a supplied vocabulary. Require aligned allowedChildren/allowedParents; matchingIndices lists exact paired matches, matches means any found.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| childRank | Child Rank | Required. Text; maximum UTF-16 length 8192. |
| parentRank | Parent Rank | Required. Text; maximum UTF-16 length 8192. |
| allowedChildren | Allowed Children | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| allowedParents | Allowed Parents | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| matches | Matches | Required. Boolean. |
| matchingIndices | Matching Indices | Required. Array of safe integer; maximum items 256. |
{
"input": {
"childRank": "species",
"parentRank": "genus",
"allowedChildren": [
"species",
"genus"
],
"allowedParents": [
"genus",
"family"
]
},
"output": {
"matches": true,
"matchingIndices": [
0
]
}
}Limitations and assumptions
- Ranks and allowed relations are supplied; duplicate pairs are allowed and no actual taxonomy or code hierarchy is validated.
- 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
- Taxonomic Autonym Parent Rank Flag
Return an autonym candidate under supplied rank/epithet flags.
- Taxon Name Diacritic Source Preserver
Preserve a supplied taxon name with source and edition key.