Description
Sum nonnegative binExposures and select a valid zero-based bin.
A histogram partitions a numeric range into finite buckets and possibly an open-ended bucket. Exposure shares are different from event counts and probability density.
Sum nonnegative binExposures and select a valid zero-based bin.
When to use this tool
Use Histogram Bin Exposure Share when you need a bucket-layout or exposure-denominator check.
How to use the tool and how it works
- Enter binExposures, selectedBin. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read totalExposure, binShare, defined. Inspect defined before interpreting the associated values.
Sum nonnegative binExposures and select a valid zero-based bin. Divide its exposure by a positive total; otherwise return binShare zero and defined false.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| binExposures | Bin Exposures | Required. Array of finite number; minimum 0; maximum items 256. |
| selectedBin | Selected Bin | Required. Safe integer; minimum 0. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| totalExposure | Total Exposure | Required. Finite number. |
| binShare | Bin Share | Required. Finite number. |
| defined | Whether the accompanying numeric result has an available denominator or required inputs. | Required. Boolean. |
{
"input": {
"binExposures": [
2,
3,
5
],
"selectedBin": 1
},
"output": {
"totalExposure": 10,
"binShare": 0.3,
"defined": true
}
}Limitations and assumptions
- The share is exposure-based, not automatically an event frequency or probability density.
- 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
Validate bucket ordering and boundary conventions and combine exposures with the appropriate observed counts.
References
Similar or alternative tools
- Histogram Open Bucket Count
Return their count as finiteBuckets and one additional open bucket.
- Rate Window Exposure Factor
Divide nonnegative observedDuration by positive windowDuration for exposureFactor.