Description
Return fraction and defined true for a positive total, otherwise fraction 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.
Return fraction and defined true for a positive total, otherwise fraction zero with defined false.
When to use this tool
Use Differential Cell Fraction Term when you need one transparent research count or denominator component.
How to use the tool and how it works
- Enter categoryCells, countedCells. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read fraction, defined. Inspect defined before interpreting the associated values.
Require nonnegative integer categoryCells within countedCells. Return fraction and defined true for a positive total, otherwise fraction zero with defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| categoryCells | Category Cells | Required. Safe integer; minimum 0. |
| countedCells | Counted Cells | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| fraction | Dimensionless fraction on the stated basis; 0.1 represents 10%. | Required. Finite number. |
| defined | Whether the associated ratio has its required denominator; inspect before using a zero placeholder. | Required. Boolean. |
{
"input": {
"categoryCells": 20,
"countedCells": 100
},
"output": {
"fraction": 0.2,
"defined": true
}
}Limitations and assumptions
- Zero is a placeholder when no cells were counted; the calculation does not identify a cell type, establish sample quality, or interpret a clinical differential.
- 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 laboratory protocol, quality controls, uncertainty, and appropriate professional interpretation.
References
Similar or alternative tools
- Hematology Differential One Cell Fraction
Add unclassified cells to the denominator only when includeUnclassified, then divide categoryCells by that denominator.
- Reticulocyte Research Count Denominator Term
Return reticulocytes/eligible and excluded/(eligible+excluded).