Description
Reconcile supplied dispensed, additional and returned trial-drug counts.
Trial records distinguish protocol labels, participant events, supply balances and cutoff policies. An inclusive cutoff differs from an exclusive one, and a drug-accountability balance does not establish adherence or a suitable dose. Supplied consent and observation states are not independently verified by a local calculation.
Reconcile supplied dispensed, additional and returned trial-drug counts.
When to use this tool
Use Trial Drug Return Count Balance when you already have dispensedUnits, additionalUnits, returnedUnits and need to reconcile supplied dispensed, additional and returned trial-drug counts.
How to use the tool and how it works
- Enter dispensedUnits, additionalUnits, returnedUnits. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read closingBalance. Use the output convention below.
Require nonnegative safe whole counts; compute dispensed+additional-returned with BigInt and export a safe integer.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| dispensedUnits | Dispensed Units | Required. Safe integer; minimum 0. |
| additionalUnits | Additional Units | Required. Safe integer; minimum 0. |
| returnedUnits | Returned Units | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| closingBalance | Exact dispensed+additional-returned integer balance; negative discrepancies are retained, not interpreted as adherence. | Required. Safe integer. |
{
"input": {
"dispensedUnits": 20,
"additionalUnits": 8,
"returnedUnits": 5
},
"output": {
"closingBalance": 23
}
}Limitations and assumptions
- Negative balances are retained and unsafe exports rejected. No adherence, dosing, inventory, actual return, accountability or appropriate medicine use is 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
Check the controlled protocol, source records, accountability logs and applicable oversight requirements. Use the full trial workflow and analysis for participant or study decisions; local date comparisons and labels do not determine safety, eligibility or treatment.
References
Similar or alternative tools
- Trial Data Cutoff Inclusion Flag
Check a supplied trial-record date against a cutoff policy.
- Trial Consent Language Label
Qualify an explicit trial-consent version by supplied language code.