Description
Return allocated and remaining specimen volume.
Clinical research distinguishes supplied protocol metadata, participant/event records, allocation bookkeeping and an analysis target. A local count, permission flag or denominator choice can help reconcile records without establishing valid consent, randomization, regulatory compliance or a reliable treatment-effect estimate.
Return allocated and remaining specimen volume.
When to use this tool
Use Sample Aliquot Retention Budget Token when checking the stated clinical-research record, allocation, timing, analysis or evidence-basis convention.
How to use the tool and how it works
- Enter totalVolume, aliquotVolumes, retainedVolume. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read allocatedVolume, remainder. Use the output convention below.
Return allocated and remaining specimen volume. Require nonnegative total/retained/aliquots and sum(aliquots)+retained <= total; allocatedVolume is that sum, remainder = total-allocated.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| totalVolume | Total Volume | Required. Finite number; minimum 0. |
| aliquotVolumes | Aliquot Volumes | Required. Array of finite number; maximum items 256. |
| retainedVolume | Retained Volume | Required. Finite number; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| allocatedVolume | Allocated Volume | Required. Finite number. |
| remainder | Remainder | Required. Finite number. |
{
"input": {
"totalVolume": 10,
"aliquotVolumes": [
2,
3
],
"retainedVolume": 1
},
"output": {
"allocatedVolume": 6,
"remainder": 4
}
}Limitations and assumptions
- Volumes share units; dead volume, sample quality, storage stability and actual clinical or laboratory suitability are not established.
- 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
Use the complete approved protocol, authenticated source records and qualified clinical/statistical oversight for actual trial design, conduct and interpretation.
References
Similar or alternative tools
- Cryostat Liquid Inventory Day Balance
Reconcile a supplied cryostat liquid inventory.
- Compartment Transfer One Timestep Term
Apply one bounded source-to-target transfer step.