Description
Return remaining volume, usable volume clamped at zero, and empty when remaining is no greater than dead volume.
Specimen quantities can be reported on a volume, wet-mass or dry-mass basis. Conversion factors and usable-volume assumptions change the denominator; they do not validate the specimen or turn a numerical ratio into a clinical result.
Return remaining volume, usable volume clamped at zero, and empty when remaining is no greater than dead volume.
When to use this tool
Use Gi Sample Aliquot Empty Base Flag when you need a specimen-volume or supplied mass-basis calculation.
How to use the tool and how it works
- Enter totalVolume, withdrawn, deadVolume. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read remaining, usable, empty. Inspect empty before interpreting the associated values.
Require nonnegative totalVolume, withdrawn and deadVolume, with withdrawal no greater than total. Return remaining volume, usable volume clamped at zero, and empty when remaining is no greater than dead volume.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| totalVolume | Total Volume | Required. Finite number; minimum 0. |
| withdrawn | Withdrawn | Required. Finite number; minimum 0. |
| deadVolume | Dead Volume | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| remaining | Remaining | Required. Finite number. |
| usable | Usable | Required. Finite number. |
| empty | Whether remaining volume is at or below dead volume, not necessarily zero physical volume. | Required. Boolean. |
{
"input": {
"totalVolume": 10,
"withdrawn": 8,
"deadVolume": 3
},
"output": {
"remaining": 2,
"usable": 0,
"empty": true
}
}Limitations and assumptions
- Volumes share units. Dead volume can exceed remaining volume; empty means no modeled usable volume, not necessarily a physically empty container.
- 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 analytical preparation and source records for units, blanks, recovery and sample condition. Use a validated method and appropriate professional interpretation for health decisions.
References
Similar or alternative tools
- Digestive Assay Mass Basis Factor
Compute dry mass and divide blank-corrected signal times calibration by dry mass.
- Diary Event Volume Unit Factor
Multiply them for convertedVolume.