Description
Match requestedLabel exactly against axisLabels and return every zero-based matching index.
Exact label matching answers whether supplied strings agree under a chosen vocabulary. It preserves a useful distinction between missing, unknown, ambiguous, and unrecognized records.
Match requestedLabel exactly against axisLabels and return every zero-based matching index.
When to use this tool
Use Kidney Image Axis Label Token when you need an explicit record-label comparison or deterministic key.
How to use the tool and how it works
- Enter axisLabels, requestedLabel. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read matchingIndices, ambiguous. Inspect ambiguous before interpreting the associated values.
Match requestedLabel exactly against axisLabels and return every zero-based matching index. Set ambiguous when there is more than one match.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| axisLabels | Axis Labels | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| requestedLabel | Requested Label | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| matchingIndices | Matching Indices | Required. Array of safe integer; maximum items 256. |
| ambiguous | Ambiguous | Required. Boolean. |
{
"input": {
"axisLabels": [
"L",
"R",
"L"
],
"requestedLabel": "L"
},
"output": {
"matchingIndices": [
0,
2
],
"ambiguous": true
}
} Limitations and assumptions
- Matching is case sensitive and literal; no image geometry, anatomical orientation, or label standard is inferred.
- 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
Normalize or reconcile identifiers only under a documented policy, then verify the underlying source records separately.
References
Similar or alternative tools
- Newborn Sample Parent Label Check
Compare parent and aliquot labels exactly and combine both flags into matches; serialize expectedParent, sampleId, and recordedAliquot as a JSON array key.
- Maternal Record Source Gap
Count matching and mismatching pairs only when neither value equals missingToken; count missing recorded and source values separately.