Pharmacogene Haplotype Member Count Budget Tool

Description

For nonnegative integer members, required, optional, and excluded<=members return eligible=members-excluded, requiredGap=eligible-required, and optionalCapacity=max(0,eligible-required-optional).

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 members, required, optional, and excluded<=members return eligible=members-excluded, requiredGap=eligible-required, and optionalCapacity=max(0,eligible-required-optional).

When to use this tool

Use Pharmacogene Haplotype Member Count Budget 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 members, required, optional, excluded. Use the units and conventions below.
Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
Read eligible, requiredGap, optionalCapacity. Use the output convention below.

For nonnegative integer members, required, optional, and excluded<=members return eligible=members-excluded, requiredGap=eligible-required, and optionalCapacity=max(0,eligible-required-optional).^[1]

Input field	Meaning and units	Accepted input
members	Members	Required. Safe integer; minimum 0.
required	Required	Required. Safe integer; minimum 0.
optional	Optional	Required. Safe integer; minimum 0.
excluded	Excluded	Required. Safe integer; minimum 0.

Output field	Interpretation	Returned shape
eligible	Eligible	Required. Safe integer.
requiredGap	Required Gap	Required. Safe integer.
optionalCapacity	Optional Capacity	Required. Safe integer.

json

{
  "input": {
    "members": 12,
    "required": 5,
    "optional": 3,
    "excluded": 2
  },
  "output": {
    "eligible": 10,
    "requiredGap": 5,
    "optionalCapacity": 2
  }
}

Limitations and assumptions

A negative requiredGap is a valid deficit. Counts alone do not establish which variants belong to a haplotype, satisfy a panel, or affect clinical function.
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

Calculation and input contract: pharmacogenomics/pharmacogene-haplotype-member-count-budget — tool.io

Similar or alternative tools

Pharmacogene Diplotype Copyallocation Budget
For nonnegative integer totalCopies, firstCopies, secondCopies, and unresolvedCopies return allocated=firstCopies+secondCopies, unaccounted=totalCopies-firstCopies-secondCopies-unresolvedCopies, and consistent on exact balance.
Genotype Call Allele Count
Count supplied allele-call tokens without calling variants, assigning phase or predicting drug response.