Description
Compare sample-matrix codes with a supplied vocabulary and expected code.
Clinical research distinguishes supplied protocol metadata, participant/event records, allocation bookkeeping and an analysis target. A local count, permission flag or denominator choice can help reconcile records without establishing valid consent, randomization, regulatory compliance or a reliable treatment-effect estimate.
Compare sample-matrix codes with a supplied vocabulary and expected code.
When to use this tool
Use Clinical Study Sample Matrix Code Pair when checking the stated clinical-research record, allocation, timing, analysis or evidence-basis convention.
How to use the tool and how it works
- Enter recordCode, labelCode, vocabulary, expectedCode. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read recordKnown, labelKnown, pairMatches, expectedMatches. Inspect recordKnown, labelKnown, pairMatches, expectedMatches before interpreting the associated values.
Compare sample-matrix codes with a supplied vocabulary and expected code. recordKnown/labelKnown test membership, pairMatches compares both codes, expectedMatches requires both equal expectedCode.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| recordCode | Record Code | Required. Text; maximum UTF-16 length 8192. |
| labelCode | Label Code | Required. Text; maximum UTF-16 length 8192. |
| vocabulary | Vocabulary | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| expectedCode | Expected Code | Required. Text; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| recordKnown | Record Known | Required. Boolean. |
| labelKnown | Label Known | Required. Boolean. |
| pairMatches | Pair Matches | Required. Boolean. |
| expectedMatches | Both codes equal expectedCode; this does not imply either code is present in vocabulary. | Required. Boolean. |
{
"input": {
"recordCode": "A",
"labelCode": "A",
"vocabulary": [
"A",
"B"
],
"expectedCode": "A"
},
"output": {
"recordKnown": true,
"labelKnown": true,
"pairMatches": true,
"expectedMatches": true
}
}Limitations and assumptions
- Expected agreement can coexist with unknown codes; no actual specimen identity, matrix suitability or vocabulary authority is verified.
- 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
Use the complete approved protocol, authenticated source records and qualified clinical/statistical oversight for actual trial design, conduct and interpretation.
References
Similar or alternative tools
- Study Translation Version Source Pair
Compare study-translation source and version metadata.
- Trial Sample Parent Visit Label
Compare sample-parent and visit labels.