Skip to content

Main content

Pharmacogenomic Sample Ploidy Mismatch Tool

Calculate pharmacogenomic sample ploidy mismatch from explicit caller-supplied inputs.

Loading tool…

Description

For nonnegative integer expected, calledCopies, and unknownCopies return knownGap=calledCopies-expected, possibleMinimum=calledCopies, possibleMaximum=calledCopies+unknownCopies, and definitelyMismatch when expected lies outside that interval.

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.

For nonnegative integer expected, calledCopies, and unknownCopies return knownGap=calledCopies-expected, possibleMinimum=calledCopies, possibleMaximum=calledCopies+unknownCopies, and definitelyMismatch when expected lies outside that interval.

When to use this tool

Use Pharmacogenomic Sample Ploidy Mismatch when you need this specific allele-token, reference-coordinate, copy-budget, or source-support check.

How to use the tool and how it works

  1. Enter expected, calledCopies, unknownCopies. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read knownGap, possibleMinimum, possibleMaximum, definitelyMismatch. Inspect definitelyMismatch before interpreting the associated values.

For nonnegative integer expected, calledCopies, and unknownCopies return knownGap=calledCopies-expected, possibleMinimum=calledCopies, possibleMaximum=calledCopies+unknownCopies, and definitelyMismatch when expected lies outside that interval.1

Input fieldMeaning and unitsAccepted input
expectedExpectedRequired. Safe integer; minimum 0.
calledCopiesCalled CopiesRequired. Safe integer; minimum 0.
unknownCopiesUnknown CopiesRequired. Safe integer; minimum 0.
Output fieldInterpretationReturned shape
knownGapKnown GapRequired. Safe integer.
possibleMinimumPossible MinimumRequired. Safe integer.
possibleMaximumPossible MaximumRequired. Safe integer.
definitelyMismatchDefinitely MismatchRequired. Boolean.
json
{
  "input": {
    "expected": 2,
    "calledCopies": 1,
    "unknownCopies": 1
  },
  "output": {
    "knownGap": -1,
    "possibleMinimum": 1,
    "possibleMaximum": 2,
    "definitelyMismatch": false
  }
}

Limitations and assumptions

  • UnknownCopies is a supplied upper-budget contribution, not a probabilistic uncertainty estimate. An expected count inside the range does not establish a correct ploidy or validated genotype.
  • 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.
  • Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Signed zero is exported as zero.

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

  1. Calculation and input contract: pharmacogenomics/pharmacogenomic-sample-ploidy-mismatch — tool.io

Similar or alternative tools