Description
Sum eligible and eligible-observed cells with exact integer arithmetic, export decimal count strings, and divide numerically or return zero with defined false.
Blood-cell research counts require a defined eligible population, exclusion rule, sampled volume, and dilution basis. Their arithmetic fractions and densities are separate from validated laboratory results and clinical reference intervals.
Sum eligible and eligible-observed cells with exact integer arithmetic, export decimal count strings, and divide numerically or return zero with defined false.
When to use this tool
Use Cell Grid Observed Share when you need one transparent research count or denominator component.
How to use the tool and how it works
- Enter cellCounts, gridObserved, gridEligible. 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 eligibleCountDecimal, observedCountDecimal, share, defined. Inspect defined before interpreting the associated values.
Require aligned nonnegative integer cellCounts and gridObserved and gridEligible flags. Sum eligible and eligible-observed cells with exact integer arithmetic, export decimal count strings, and divide numerically or return zero with defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| cellCounts | Cell Counts | Required. Array of safe integer; minimum 0; maximum items 256. |
| gridObserved | Grid Observed | Required. Array of boolean; maximum items 256. |
| gridEligible | Grid Eligible | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| eligibleCountDecimal | Exact count-string total on eligible grid records. | Required. Text; maximum UTF-16 length 8192. |
| observedCountDecimal | Exact count-string total on eligible observed grid records. | Required. Text; maximum UTF-16 length 8192. |
| share | Dimensionless share under the stated denominator and exclusion convention. | Required. Finite number. |
| defined | Whether the associated ratio has its required denominator; inspect before using a zero placeholder. | Required. Boolean. |
{
"input": {
"cellCounts": [
2,
3,
5
],
"gridObserved": [
true,
false,
true
],
"gridEligible": [
true,
true,
false
]
},
"output": {
"eligibleCountDecimal": "5",
"observedCountDecimal": "2",
"share": 0.4,
"defined": true
}
}Limitations and assumptions
- Support is weighted by supplied cell counts, not grid count; exact totals do not validate observations, sampling, or clinical cell measurements.
- 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
Review the complete laboratory protocol, quality controls, uncertainty, and appropriate professional interpretation.
References
Similar or alternative tools
- Differential Cell Fraction Term
Return fraction and defined true for a positive total, otherwise fraction zero with defined false.
- Reticulocyte Research Count Denominator Term
Return reticulocytes/eligible and excluded/(eligible+excluded).