Description
Count rows with an edition different from requiredEdition, rows whose allele is absent from verifiedAlleles, and rows meeting both checks as fullySupported.
Pharmacogenomic records distinguish allele labels, copy counts, reference-sequence versions, coordinate systems, and evidence about chromosome phase. A balanced count or matching token can check a record without establishing the underlying genotype. Supplied activity values and interpretation rules remain separate from a current gene-specific clinical guideline.
Count rows with an edition different from requiredEdition, rows whose allele is absent from verifiedAlleles, and rows meeting both checks as fullySupported.
When to use this tool
Use Allele Source Edition Gap when you need this specific allele-token, reference-coordinate, copy-budget, or source-support check.
How to use the tool and how it works
- Enter alleleIds, recordedEditions, requiredEdition, verifiedAlleles. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read editionMismatches, unverifiedAlleles, fullySupported. Use the output convention below.
Require aligned alleleIds and recordedEditions. Count rows with an edition different from requiredEdition, rows whose allele is absent from verifiedAlleles, and rows meeting both checks as fullySupported.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| alleleIds | Allele Ids | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| recordedEditions | Recorded Editions | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| requiredEdition | Required Edition | Required. Text; maximum UTF-16 length 8192. |
| verifiedAlleles | Verified Alleles | Required. Array of text; maximum UTF-16 length 8192; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| editionMismatches | Edition Mismatches | Required. Safe integer. |
| unverifiedAlleles | Unverified Alleles | Required. Safe integer. |
| fullySupported | Fully Supported | Required. Safe integer. |
{
"input": {
"alleleIds": [
"a",
"b"
],
"recordedEditions": [
"v2",
"v1"
],
"requiredEdition": "v2",
"verifiedAlleles": [
"a"
]
},
"output": {
"editionMismatches": 1,
"unverifiedAlleles": 1,
"fullySupported": 1
}
}Limitations and assumptions
- Counts are row-based, so duplicate allele IDs count repeatedly. The supplied edition and verification list are not independently authenticated or checked for current clinical guidance.
- 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 a current gene-specific nomenclature and a validated interpretation process when allele identity, phase, function, or clinical decisions matter. Verify source versions and reference coordinates before combining records.
References
Similar or alternative tools
- Allele Call Confidence Margin
Compare caller-supplied research call confidence to an explicit boundary without phenotype or drug guidance.
- Genotype Call Allele Count
Count supplied allele-call tokens without calling variants, assigning phase or predicting drug response.