Description
Subtract excluded parent and child events from their counts, validating nested counts and exclusions.
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.
Subtract excluded parent and child events from their counts, validating nested counts and exclusions.
When to use this tool
Use Gated Cell Denominator Share when you need one transparent research-assay calculation or event-accounting check.
How to use the tool and how it works
- Enter childEvents, parentEvents, excludedParentEvents, excludedChildEvents. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read eligibleParent, eligibleChild, share, defined. Inspect defined before interpreting the associated values.
Subtract excluded parent and child events from their counts, validating nested counts and exclusions. Return eligibleChild/eligibleParent when the latter is positive, otherwise share zero and defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| childEvents | Child Events | Required. Safe integer; minimum 0. |
| parentEvents | Parent Events | Required. Safe integer; minimum 0. |
| excludedParentEvents | Excluded Parent Events | Required. Safe integer; minimum 0. |
| excludedChildEvents | Excluded Child Events | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| eligibleParent | Eligible Parent | Required. Safe integer. |
| eligibleChild | Eligible Child | Required. Safe integer. |
| share | Eligible child events divided by eligible parent events, or zero placeholder when undefined. | Required. Finite number. |
| defined | Whether the associated ratio has its required denominator; inspect before using a zero placeholder. | Required. Boolean. |
{
"input": {
"childEvents": 40,
"parentEvents": 100,
"excludedParentEvents": 20,
"excludedChildEvents": 10
},
"output": {
"eligibleParent": 80,
"eligibleChild": 30,
"share": 0.375,
"defined": true
}
}Limitations and assumptions
- Zero is a placeholder when defined is false. This checks supplied event accounting without evaluating gating quality, event identity, or a biological conclusion.
- 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
- Flow Gate Child Parent Share
Return their ratio with defined true when the parent count is positive, otherwise share zero and defined false.
- Flow Gate Unknown Parent Budget
Validate nonnegative event counts and excludedUnknown no greater than unknownParentEvents, with known plus unknown no greater than recordedEvents.