Description
Attach a candidate animal identity and a supplied confirmation flag to an observation.
Zoological records separate specimen identity, preparation, anatomical side, behavioral codes and the sources assigning those labels. A specimen name or status is a claim with provenance, while an observation share depends on a stated denominator. Preserving these conventions helps compare records without treating a transcription or visibility count as taxonomic identification or an animal-health assessment.
Attach a candidate animal identity and a supplied confirmation flag to an observation.
When to use this tool
Use Animal Identity Uncertainty Tag when you already have observationId, candidateId, confirmed and need to attach a candidate animal identity and a supplied confirmation flag to an observation.
How to use the tool and how it works
- Enter observationId, candidateId, confirmed. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read tag. Use the output convention below.
Require nonempty observationId/candidateId; format the candidate with JSON quoting and identity=recorded-confirmed when confirmed, otherwise uncertain.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| observationId | Observation Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| candidateId | Candidate Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| confirmed | Confirmed | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| tag | Tag | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"observationId": "O17",
"candidateId": "A3",
"confirmed": false
},
"output": {
"tag": "O17; candidate=\"A3\"; identity=uncertain"
}
}Limitations and assumptions
- A true confirmation flag records a claim; it does not perform recognition or prove identity.
- 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
For identity or type status, inspect the original specimen record and cited nomenclatural authority. For behavior or visibility, review the actual observation series and its codebook; this helper preserves one stated label or counting convention.
References
Similar or alternative tools
- Animal Observation Agecertainty Code
Label the recorded certainty of an animal's age.
- Animal Observation Vocalization Label
Record an animal vocalization code and its codebook source.