Description
Sum only flagged counts with exact integers and return observed, reference, and signed gap as decimal strings.
A residual is the signed difference between an observation and a declared reference or blank. Retaining its sign is useful for detecting overcorrection and incompatible measurement bases.
Sum only flagged counts with exact integers and return observed, reference, and signed gap as decimal strings.
When to use this tool
Use Assay Count Support Gap when you need an explicit assay residual or supported-count comparison.
How to use the tool and how it works
- Enter counts, validDenominator, referenceCounts. 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 observedSupportedDecimal, referenceSupportedDecimal, gapDecimal. Use the output convention below.
Require aligned nonnegative integer count arrays and validDenominator flags. Sum only flagged counts with exact integers and return observed, reference, and signed gap as decimal strings.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| counts | Counts | Required. Array of safe integer; maximum items 256. |
| validDenominator | Valid Denominator | Required. Array of boolean; maximum items 256. |
| referenceCounts | Reference Counts | Required. Array of safe integer; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| observedSupportedDecimal | Observed Supported Decimal | Required. Text; maximum UTF-16 length 8192. |
| referenceSupportedDecimal | Reference Supported Decimal | Required. Text; maximum UTF-16 length 8192. |
| gapDecimal | Gap Decimal | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"counts": [
2,
5
],
"validDenominator": [
true,
false
],
"referenceCounts": [
3,
4
]
},
"output": {
"observedSupportedDecimal": "2",
"referenceSupportedDecimal": "3",
"gapDecimal": "-1"
}
}Limitations and assumptions
- Unflagged entries are omitted from both totals; denominator validity is supplied and no statistical test is performed.
- 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
Inspect measurement uncertainty, reporting qualifiers, and the original laboratory records before interpreting a discrepancy.
References
Similar or alternative tools
- Microbial Blank Negative Case Token
Subtract blank from signal and return separate negative and exact-zero flags.
- Microbial Biomass Dry Mass Volume Factor
Subtract filterTare and blankNetMass from grossDryMass for netDryMass, then divide by positive sampleVolume.