Analyzer Channel Reference Gap Tool

Description

For selectedChannel, return record count, mean reading-minus-reference, and largest absolute gap; return zeros with defined false when none match.

Analyzer signals and research counts can require background correction and reference comparisons. A signed residual can describe the data without identifying its cause or establishing a valid clinical measurement.

For selectedChannel, return record count, mean reading-minus-reference, and largest absolute gap; return zeros with defined false when none match.

When to use this tool

Use Analyzer Channel Reference Gap when you need one explicit analyzer signal or reference component.

How to use the tool and how it works

Enter channelIds, readings, suppliedReferences, selectedChannel. 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 pairs, meanGap, largestAbsoluteGap, defined. Inspect defined before interpreting the associated values.

Require aligned channelIds, readings, and suppliedReferences. For selectedChannel, return record count, mean reading-minus-reference, and largest absolute gap; return zeros with defined false when none match.^[1]

Input field	Meaning and units	Accepted input
channelIds	Channel Ids	Required. Array of text; maximum UTF-16 length 8192; maximum items 256.
readings	Readings	Required. Array of finite number; maximum items 256.
suppliedReferences	Supplied References	Required. Array of finite number; maximum items 256.
selectedChannel	Selected Channel	Required. Text; maximum UTF-16 length 8192.

Output field	Interpretation	Returned shape
pairs	Pairs	Required. Safe integer.
meanGap	Mean Gap	Required. Finite number.
largestAbsoluteGap	Largest Absolute Gap	Required. Finite number.
defined	Whether the associated ratio has its required denominator; inspect before using a zero placeholder.	Required. Boolean.

json

{
  "input": {
    "channelIds": [
      "A",
      "B",
      "A"
    ],
    "readings": [
      2,
      5,
      6
    ],
    "suppliedReferences": [
      1,
      5,
      4
    ],
    "selectedChannel": "A"
  },
  "output": {
    "pairs": 2,
    "meanGap": 1.5,
    "largestAbsoluteGap": 2,
    "defined": true
  }
}

Limitations and assumptions

Duplicate channel records contribute separately; signals share a scale and no calibration tolerance, analyzer validity, or clinical assessment is selected.
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. Numeric signed-zero results are exported as zero.

Alternative or Complementary methods

Review calibration, controls, exposure basis, uncertainty, and the complete laboratory interpretation.

References

Calculation and input contract: hematology/analyzer-channel-reference-gap — tool.io

Similar or alternative tools

Hematology Duplicate Count Percent Gap
Return their mean and signed and absolute second-minus-first differences as percentages of that mean.
Clotting Signal Baseline Offset
Subtract baseline from signal and then referenceCorrected for residual.