Description
Sum all durations into exposureTime and those satisfying all flags into supportedTime; return share=supportedTime/exposureTime when positive, otherwise zero with defined=false.
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.
Sum all durations into exposureTime and those satisfying all flags into supportedTime; return share=supportedTime/exposureTime when positive, otherwise zero with defined=false.
When to use this tool
Use Exposure Observation Support Share 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 exposureDurations, observed, codingVerified, eligibilityKnown. Keep parallel arrays aligned. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read exposureTime, supportedTime, share, defined. Inspect defined before interpreting the associated values.
Require aligned nonnegative exposureDurations with observed, codingVerified, and eligibilityKnown flags. Sum all durations into exposureTime and those satisfying all flags into supportedTime; return share=supportedTime/exposureTime when positive, otherwise zero with defined=false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| exposureDurations | Exposure Durations | Required. Array of finite number; minimum 0; maximum items 256. |
| observed | Observed | Required. Array of boolean; maximum items 256. |
| codingVerified | Coding Verified | Required. Array of boolean; maximum items 256. |
| eligibilityKnown | Eligibility Known | Required. Array of boolean; maximum items 256. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| exposureTime | Exposure Time | Required. Finite number. |
| supportedTime | Supported Time | Required. Finite number. |
| share | Dimensionless share under the stated denominator; not a percent numeral. | Required. Finite number. |
| defined | Whether the associated denominator or quantity is defined; read before using a zero placeholder. | Required. Boolean. |
{
"input": {
"exposureDurations": [
2,
3,
5
],
"observed": [
true,
true,
true
],
"codingVerified": [
true,
true,
false
],
"eligibilityKnown": [
true,
false,
true
]
},
"output": {
"exposureTime": 10,
"supportedTime": 2,
"share": 0.2,
"defined": true
}
}Limitations and assumptions
- Overlapping episodes are not merged and support flags are supplied. This measures record-supported duration, not verified drug consumption, causal exposure, adherence, or study validity.
- 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
- Comparator Washout Support Share
Audit explicit comparator research eligibility evidence without choosing a washout duration.
- Drug Study Washout Unknown Base
Audit supplied study washout classifications without selecting a washout duration or eligibility criterion.