Description
Validate nonnegative event counts and excludedUnknown no greater than unknownParentEvents, with known plus unknown no greater than recordedEvents.
Immune-assay data can contain raw signals, blanks, gated event counts, dilution labels, and research thresholds. Their units and denominators differ, and arithmetic on supplied values is separate from assay validation or clinical interpretation.
Validate nonnegative event counts and excludedUnknown no greater than unknownParentEvents, with known plus unknown no greater than recordedEvents.
When to use this tool
Use Flow Gate Unknown Parent Budget when you need one transparent research-assay calculation or event-accounting check.
How to use the tool and how it works
- Enter recordedEvents, knownParentEvents, unknownParentEvents, excludedUnknown. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read eligibleKnown, unresolved, unassigned. Use the output convention below.
Validate nonnegative event counts and excludedUnknown no greater than unknownParentEvents, with known plus unknown no greater than recordedEvents. Return eligibleKnown, unresolved unknown minus excludedUnknown, and unassigned recorded remainder.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| recordedEvents | Recorded Events | Required. Safe integer; minimum 0. |
| knownParentEvents | Known Parent Events | Required. Safe integer; minimum 0. |
| unknownParentEvents | Unknown Parent Events | Required. Safe integer; minimum 0. |
| excludedUnknown | Excluded Unknown | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| eligibleKnown | Eligible Known | Required. Safe integer. |
| unresolved | Unresolved | Required. Safe integer. |
| unassigned | Unassigned | Required. Safe integer. |
{
"input": {
"recordedEvents": 100,
"knownParentEvents": 70,
"unknownParentEvents": 20,
"excludedUnknown": 5
},
"output": {
"eligibleKnown": 70,
"unresolved": 15,
"unassigned": 10
}
}Limitations and assumptions
- Unknown and unassigned are distinct bookkeeping groups; no parent gate, event identity, or missing-event mechanism is inferred.
- 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 the complete assay protocol, calibration, controls, uncertainty, and appropriate professional interpretation.
References
Similar or alternative tools
- Gated Cell Denominator Share
Subtract excluded parent and child events from their counts, validating nested counts and exclusions.
- Flow Gate Child Parent Share
Return their ratio with defined true when the parent count is positive, otherwise share zero and defined false.