Description
Return an autonym candidate under supplied rank/epithet flags.
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 an autonym candidate under supplied rank/epithet flags.
When to use this tool
Use Taxonomic Autonym Parent Rank Flag when checking the stated taxonomic source, name-token, date or concept-support convention.
How to use the tool and how it works
- Enter epithet, parentEpithet, rank, suppliedAutonymRanks. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read epithetMatches, rankListed, candidateUnderFlags. Inspect epithetMatches, rankListed, candidateUnderFlags before interpreting the associated values.
Return an autonym candidate under supplied rank/epithet flags. epithetMatches compares parent epithet, rankListed checks suppliedAutonymRanks, candidateUnderFlags requires both.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| epithet | Epithet | Required. Text; maximum UTF-16 length 8192. |
| parentEpithet | Parent Epithet | Required. Text; maximum UTF-16 length 8192. |
| rank | Rank | Required. Text; maximum UTF-16 length 8192. |
| suppliedAutonymRanks | Supplied Autonym Ranks | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| epithetMatches | Epithet Matches | Required. Boolean. |
| rankListed | Rank Listed | Required. Boolean. |
| candidateUnderFlags | Candidate Under Flags | Required. Boolean. |
{
"input": {
"epithet": "alba",
"parentEpithet": "alba",
"rank": "var.",
"suppliedAutonymRanks": [
"var.",
"subsp."
]
},
"output": {
"epithetMatches": true,
"rankListed": true,
"candidateUnderFlags": true
}
}Limitations and assumptions
- This is not a determination that an autonym exists or satisfies the applicable nomenclatural code.
- 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
- Taxon Rank Supplied Parent Match
Find a child/parent rank pair in a supplied vocabulary.
- Taxonomic Combination Basionym Link
Compare a combination's supplied basionym link and epithet.