Description
Apply a supplied stockpile-day scenario and observation censor boundary without inferring adherence or prescribing.
Drug-utilization research often reconstructs exposure from dispensing dates, supplied coverage windows, coding systems, and eligibility records. Day counts depend on endpoint and stockpiling policies. Observed records, assumed exposure, and actual medication consumption are different quantities.
Apply a supplied stockpile-day scenario and observation censor boundary without inferring adherence or prescribing.
When to use this tool
Use Observation Window Stockpile Offset when you need this explicit exposure-record, date-window, reporting-base, or evidence-support calculation.
How to use the tool and how it works
- Enter nominalEndDay, suppliedCarriedDays, observationEndDay, countStockpile. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read adjustedEnd, observedEnd, beyondObservation. Use the output convention below.
For nonnegative integer suppliedCarriedDays return adjustedEnd=nominalEndDay plus carried days only if countStockpile, observedEnd=min(observationEndDay,adjustedEnd), and beyondObservation=max(0,adjustedEnd-observationEndDay).1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| nominalEndDay | Nominal End Day | Required. Safe integer. |
| suppliedCarriedDays | Supplied Carried Days | Required. Safe integer; minimum 0. |
| observationEndDay | Observation End Day | Required. Safe integer. |
| countStockpile | Count Stockpile | Required. Boolean. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| adjustedEnd | Adjusted End | Required. Safe integer. |
| observedEnd | Observed End | Required. Safe integer. |
| beyondObservation | Beyond Observation | Required. Safe integer. |
{
"input": {
"nominalEndDay": 100,
"suppliedCarriedDays": 20,
"observationEndDay": 110,
"countStockpile": true
},
"output": {
"adjustedEnd": 120,
"observedEnd": 110,
"beyondObservation": 10
}
}Limitations and assumptions
- Only an end coordinate is clipped; there is no observation-start check or reconstructed possession episode. Carried supply is assumed, not verified as consumed medication.
- 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. Signed zero is exported as zero.
Alternative or Complementary methods
Choose a documented exposure and eligibility definition for the study before combining records. Verify the coding version, observation windows, endpoint convention, and the evidence for assumptions about carried supply.
References
Similar or alternative tools
- Exposure Overlap Stockpile Term
Apply an explicit stockpile duration cap to deidentified exposure-record overlap without inferring medicine use.
- Exposure Episode Offset Credit
Shift supplied half-open record episodes and remove explicitly supplied overlap credit.